文档首页/ 应用与数据集成平台 ROMA Connect/ API参考/ 服务集成API/ 自定义后端服务/ 查询后端API列表

更新时间：2024-07-03 GMT+08:00

在线调试

CLI示例

查看PDF

查询后端API列表

功能介绍

获取某个实例下的所有后端API。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v2/{project_id}/apic/instances/{instance_id}/livedata-apis

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID，获取方式请参见API参考的“附录 > 获取项目ID”章节。
instance_id	是	String	实例ID

表2 Query参数
参数	是否必选	参数类型	描述
offset	否	Long	偏移量，表示从此偏移量开始查询，偏移量小于0时，自动转换为0 缺省值：0
limit	否	Integer	每页显示的条目数量最小值：1 最大值：500 缺省值：20
app_id	否	String	后端API归属的集成应用编号
app_name	否	String	后端API归属的集成应用名称
name	否	String	后端API名称
status	否	String	后端API状态，支持1，3，4，分别表示待开发，开发中和已部署状态
path	否	String	后端API请求路径
precise_search	否	String	指定需要精确匹配查找的参数名称，多个参数需要支持精确匹配时参数之间使用“,”隔开。当前支持name，path，status。

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

响应参数

状态码： 200

表4 响应Body参数
参数	参数类型	描述
size	Integer	本次返回的列表长度
total	Long	满足条件的记录数
apis	Array of LdApiInfo objects	本次查询到的API列表

表5 LdApiInfo
参数	参数类型	描述
name	String	后端API名称。支持汉字、英文、数字、中划线、下划线、点、斜杠、中英文格式下的小括号和冒号、中文格式下的顿号，且只能以英文、汉字和数字开头。最小长度：3 最大长度：100
path	String	后端API请求路径。支持英文、数字、中划线、下划线、点等，且以斜杠（/）开头。更新后端API时，status=4为后端API的已部署状态，该状态下后端API请求路径不能修改。最小长度：2 最大长度：256
method	String	后端API请求方法。支持GET、PUT、POST、DELETE 更新后端API时，status=4为后端API的已部署状态，该状态下后端API请求方法不能修改。
description	String	后端API描述。不支持<，>字符最小长度：0 最大长度：1000
version	String	后端API版本支持英文、数字、下划线、中划线、点。最小长度：1 最大长度：63
content_type	String	后端API返回类型缺省值：json
api_signature_id	String	后端API为签名认证时绑定的签名密钥编号最小长度：1 最大长度：64
roma_app_id	String	后端API归属的集成应用编号更新后端API时，status=4为后端API的已部署状态，该状态下后端API归属的集成应用编号不能修改。最小长度：1 最大长度：65
return_format	Boolean	API响应信息是否格式化 true：对响应信息进行格式化 false：对响应信息格式化不进行格式化缺省值：false
parameters	Array of LdApiParameter objects	后端API的请求参数列表
id	String	后端API编号
instance	String	后端API所属实例编号
type	String	后端API类型： data：数据后端 function：函数后端
status	Integer	后端API状态： 1：待开发 3：开发中 4：已部署
created_time	String	后端API创建时间
modified_time	String	后端API修改时间
scripts	Array of LdApiScript objects	后端API脚本信息
roma_app_name	String	后端API归属的集成应用名称

表6 LdApiParameter
参数	参数类型	描述
name	String	参数名称：参数位于Headers、 Parameters时，用户自行定义，支持英文、数字、点、中划线、下划线，且需要英文开头，不区分大小写。参数位于Body时候，参数以application/json、application/xml、application/text为名，但实际是以请求body里的键值对作为参数名和参数值，比如请求消息样例，参数名为application/json，参数值为{"table":"apic01","id":"1"}，后端取table：apic01，id：1这两个键值对作为入参。注意：定义参数不要重名，否则会覆盖掉，当Headers、Parameters重复时候，Parameters会被覆盖，当Parameters和Body里的键值对重复时候，Parameters会被覆盖。最小长度：1 最大长度：32
in	String	该参数在调用API时候所放的位置： Headers ：放于请求头 Parameters ：放于请求参数 Body：放于请求体
default	String	参数默认值最大长度：4000
description	String	参数描述不支持<，>字符最小长度：0 最大长度：255
required	Boolean	参数是否必须。true：必须，false：不必须缺省值：false

表7 LdApiScript
参数	参数类型	描述
ds_id	String	数据源编号，当api_type = data时，必选
ds_name	String	数据源名称
ds_type	String	数据源类型： oracle：oracle数据源类型 mysql：mysql数据源类型 mongodb：mongodb数据源类型 redis：redis数据源类型 postgresql：postgresql/opengauss数据源类型 hive：hive数据源类型 mssql：sqlserver数据源类型 sqlserver：sqlserver数据源类型 dws：dws数据源类型 gauss100：gauss100数据源类型 zenith：zenith数据源类型 hana: hana数据源类型 clickhouse: clickhouse数据源类型 mrshive: mrshive数据源类型(tag:Site_hybrid)
type	String	脚本类型 SQL：SQL语句 SP：存储过程
object_name	String	返回对象。最小长度：1 最大长度：32
content	String	API脚本内容请对脚本进行base64编码最小长度：1 最大长度：100000
enable_result_paging	Boolean	数据脚本是否结果分页，当api_type = data时有效缺省值：false
enable_preparestatement	Boolean	数据脚本是否预编译，当api_type = data时有效缺省值：false
created_time	String	后端API脚本创建时间
modified_time	String	后端API脚本修改时间

状态码： 400

表8 响应Body参数
参数	参数类型	描述
error_code	String	错误码
error_msg	String	错误描述

状态码： 401

表9 响应Body参数
参数	参数类型	描述
error_code	String	错误码
error_msg	String	错误描述

状态码： 403

**表10** 响应Body参数
参数	参数类型	描述
error_code	String	错误码
error_msg	String	错误描述

状态码： 404

**表11** 响应Body参数
参数	参数类型	描述
error_code	String	错误码
error_msg	String	错误描述

状态码： 500

**表12** 响应Body参数
参数	参数类型	描述
error_code	String	错误码
error_msg	String	错误描述

请求示例

无

响应示例

状态码： 200

{
  "total" : 1,
  "size" : 1,
  "apis" : [ {
    "content_type" : "json",
    "created_time" : "2020-09-18T09:25:59Z",
    "description" : "",
    "id" : "bd42841c20184da6bbf457c6d8a06e37",
    "instance" : "f0fa1789-3b76-433b-a787-9892951c620e",
    "method" : "GET",
    "modified_time" : "2020-09-18T09:37:28Z",
    "name" : "livedata_api_demo",
    "parameters" : [ ],
    "path" : "/test/function",
    "return_format" : false,
    "roma_app_id" : "98df09fb-d459-4cbf-83a7-2b55ca6f3d5d",
    "roma_app_name" : "app-demo",
    "scripts" : [ ],
    "status" : 1,
    "type" : "",
    "version" : "1.0.1"
  } ]
}

状态码： 400

Bad Request

{
  "error_code" : "APIG.2011",
  "error_msg" : "Invalid parameter value,parameterName:instance_id. Please refer to the support documentation"
}

状态码： 401

Unauthorized

{
  "error_code" : "APIG.1002",
  "error_msg" : "Incorrect token or token resolution failed"
}

状态码： 403

Forbidden

{
  "error_code" : "APIG.1005",
  "error_msg" : "No permissions to request this method"
}

状态码： 404

Not Found

{
  "error_code" : "APIG.3030",
  "error_msg" : "The instance does not exist;id:f0fa1789-3b76-433b-a787-9892951c620ec"
}

状态码： 500

Internal Server Error

{
  "error_code" : "APIG.9999",
  "error_msg" : "System error"
}

状态码

状态码	描述
200	OK
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
500	Internal Server Error

错误码

请参见错误码。

父主题： 自定义后端服务

上一篇：查询后端API详情

下一篇：创建后端API脚本

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

查询后端API列表

功能介绍

调试

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线