数据治理中心 DataArts Studio-查询API信息:响应
响应
- 响应样例
{"backend_config": null,"create_time": 1589186805000,"datasource_config": {"access_mode": "SQL","backend_paras": [{"condition": "CONDITION_TYPE_EQ","mapping": "a1","name": "p"},{"condition": "CONDITION_TYPE_EQ","mapping": "a3","name": "q"},{"condition": "CONDITION_TYPE_EQ","mapping": "a2","name": "h"}],"connection_id": "8a94809170fa181e0170fd2cbb610007","database": "default","order_paras": [{"field": "a1","name": "o1","optional": false,"order": 1,"sort": "ASC"},{"field": "a2","name": "o2","optional": true,"order": 2,"sort": "CUSTOM"}],"pagination": "DEFAULT","queue": "default","response_paras": [{"description": "","example_value": "","field": "a1","name": "a1x","type": "REQUEST_PARAMETER_TYPE_STRING"},{"description": "","example_value": "","field": "a2","name": "a2","type": "REQUEST_PARAMETER_TYPE_STRING"},{"description": "","example_value": "1","field": "a3","name": "a3","type": "REQUEST_PARAMETER_TYPE_NUMBER"}],"sql": null,"type": "DLI"},"description": "update","host": "e7c91cd2d4714e81807b7d4c273f791c.apig.xxxxxx.apis.com","id": "f2108870c3867c3080cf5dfcc1f1a66c","log_flag": true,"manager": "test","name": "testOpenApi_create_configuration_update","path": "/testOpenApi_configuration/{p}","protocol": "PROTOCOL_TYPE_HTTP","publish_type": "PUBLISH_TYPE_PRIVATE","request_paras": [{"default_value": "","description": "","example_value": "","name": "h","necessary": false,"position": "REQUEST_PARAMETER_POSITION_HEADER","type": "REQUEST_PARAMETER_TYPE_STRING"},{"default_value": null,"description": "123","example_value": null,"name": "p","necessary": true,"position": "REQUEST_PARAMETER_POSITION_PATH","type": "REQUEST_PARAMETER_TYPE_NUMBER"},{"default_value": null,"description": "","example_value": null,"name": "q","necessary": true,"position": "REQUEST_PARAMETER_POSITION_QUERY","type": "REQUEST_PARAMETER_TYPE_NUMBER"}],"request_type": "REQUEST_TYPE_GET","update_time": 1589202148000,"create_user": "abc","debug_status": "API_DEBUG_SUCCESS","group_id": "123","hosts": null,"status": "API_STATUS_CREATED"}
- 响应Body参数
参数
参数类型
描述
id
String
API的ID
name
String
API名称
group_id
String
API所属分组的ID
description
String
API 描述
protocol
String
API 访问协议
枚举值:
- PROTOCOL_TYPE_HTTP
- PROTOCOL_TYPE_HTTPS
publish_type
String
发布类型,公开或者私有
枚举值:
- PUBLISH_TYPE_PUBLIC
- PUBLISH_TYPE_PRIVATE
log_flag
Boolean
是否开启日志记录
path
String
API的访问路径
host
String
共享版域名
hosts
InstanceHostDTO object
专享版域名
request_type
String
API访问方式
枚举值:
- REQUEST_TYPE_POST
- REQUEST_TYPE_GET
create_user
String
API创建者
create_time
Long
创建时间
update_time
Long
更新时间
manager
String
API 审核人名称
status
String
API的状态
枚举值:
- API_STATUS_CREATED
- API_STATUS_PUBLISH_WAIT_REVIEW
- API_STATUS_PUBLISH_REJECT
- API_STATUS_PUBLISHED
- API_STATUS_WAITING_STOP
- API_STATUS_STOPPED
- API_STATUS_RECOVER_WAIT_REVIEW
- API_STATUS_WAITING_OFFLINE
- API_STATUS_OFFLINE
- API_STATUS_OFFLINE_WAIT_REVIEW
type
String
API 类型
枚举值:
- API_SPECIFIC_TYPE_CONFIGURATION
- API_SPECIFIC_TYPE_SCRIPT
- API_SPECIFIC_TYPE_REGISTER
debug_status
String
API调试状态
枚举值:
- API_DEBUG_WAITING
- API_DEBUG_FAILED
- API_DEBUG_SUCCESS
request_paras
Array of RequestPara objects
API请求参数
datasource_config
DatasourceConfig object
数据源配置
backend_config
BackendConfig object
后端配置
表1 InstanceHostDTO 参数
参数类型
描述
instance_id
String
集群id
instance_name
String
集群名
intranet_host
String
内网地址
external_host
String
外网地址
domains
Array of strings
网关域名
表2 RequestPara 参数
参数类型
描述
name
String
参数名
position
String
参数的位置
枚举值:
- REQUEST_PARAMETER_POSITION_PATH
- REQUEST_PARAMETER_POSITION_HEADER
- REQUEST_PARAMETER_POSITION_QUERY
type
String
参数的类型
枚举值:
- REQUEST_PARAMETER_TYPE_NUMBER
- REQUEST_PARAMETER_TYPE_STRING
description
String
参数的描述
necessary
Boolean
参数是否必填
example_value
String
实例值
default_value
String
默认值
表3 DatasourceConfig 参数
参数类型
描述
type
String
数据源的类型
枚举值:
- MYSQL
- DLI
- DWS
- HIVE
- HBASE
connection_name
String
数据连接名称
connection_id
String
数据连接ID
database
String
数据库名
datatable
String
数据表名称
table_id
String
数据表ID
queue
String
DLI的队列名称
access_type
String
取数方式
枚举值:
- SCRIPT
- CONFIGURAITON
access_mode
String
获取数据的模式
枚举值:
- SQL
- ROW_KEY
- PREFIX_FILTER
pagination
String
枚举值:
- DEFAULT
- CUSTOM
sql
String
脚本模式下的sql语句
backend_paras
Array of ApiRequestPara objects
API后端参数
response_paras
Array of ApiResponsePara objects
配置类API返回参数
order_paras
Array of DatasourceOrderPara objects
排序参数
表4 ApiRequestPara 参数
参数类型
描述
name
String
参数名称
mapping
String
映射字段
condition
String
操作符
枚举值:
- CONDITION_TYPE_EQ
- CONDITION_TYPE_NE
- CONDITION_TYPE_GT
- CONDITION_TYPE_GE
- CONDITION_TYPE_LT
- CONDITION_TYPE_LE
- CONDITION_TYPE_LIKE
- CONDITION_TYPE_LIKE_L
- CONDITION_TYPE_LIKE_R
表5 ApiResponsePara 参数
参数类型
描述
name
String
参数名
field
String
绑定的表字段
type
String
参数类型
枚举值:
- REQUEST_PARAMETER_TYPE_NUMBER
- REQUEST_PARAMETER_TYPE_STRING
description
String
参数描述
example_value
String
参数示例值
表6 DatasourceOrderPara 参数
参数类型
描述
name
String
排序参数名称
field
String
对应的参数字段
optional
Boolean
是否可选
sort
String
排序方式
枚举值:
- ASC
- DESC
- CUSTOM
order
Integer
排序参数顺序
表7 BackendConfig 参数
参数类型
描述
type
String
后端请求类型
枚举值:
- REQUEST_TYPE_POST
- REQUEST_TYPE_GET
protocol
String
后端请求协议类型
枚举值:
- PROTOCOL_TYPE_HTTP
- PROTOCOL_TYPE_HTTPS
host
String
后端host
timeout
Integer
后端超时时间
path
String
后端请求Path
backend_paras
Array of BackendRequestPara objects
API后端参数
constant_paras
Array of BackendConstant objects
后端常量参数
表8 BackendRequestPara 参数
参数类型
描述
name
String
api请求参数名称
position
String
参数位置
枚举值:
- REQUEST_PARAMETER_POSITION_PATH
- REQUEST_PARAMETER_POSITION_HEADER
- REQUEST_PARAMETER_POSITION_QUERY
backend_para_name
String
对应的后端参数
表9 BackendConstant 参数
参数类型
描述
name
String
常量参数名
type
String
常量参数类型
枚举值:
- REQUEST_PARAMETER_TYPE_NUMBER
- REQUEST_PARAMETER_TYPE_STRING
position
String
常量参数位置
枚举值:
- REQUEST_PARAMETER_POSITION_PATH
- REQUEST_PARAMETER_POSITION_HEADER
- REQUEST_PARAMETER_POSITION_QUERY
description
String
常量参数描述
value
String
常量参数值