更新时间:2024-12-10 GMT+08:00
分享

查询API列表

功能

查询API列表。

表1 SLA项

SLA项

定义

请求成功率

>=99.9%

可用性

Tair1

数据一致性

最终一致,不一致时长<1分钟

吞吐量

4000tps

TP50请求时延

2ms

TP99.9请求时延

5ms

注意事项

调用方法

GET

URI

/rest/gaia/dataapi/v1/api/querylist

路径参数

查询参数
表2 查询参数

参数

是否必选

类型

值域

说明

start

integer

0~1000000000

默认值:0

起始页

limit

integer

0~1000

默认值:100

分页

name

string

0~256个字符

API名称,支持模糊查询

full_name

string

0~256个字符

API全名

catalog_id

string

0~64个字符

层级ID

catalog_parent_id

string

0~64个字符

层级父ID

api_status

string

0~32个字符

标签,支持多选

api_debug

string

0~32个字符

状态,支持多选

start_time

string

0~32个字符

起始时间范围

end_time

string

0~32个字符

结束时间范围

create_user

string

0~64个字符

创建人

sort_key

string

0~64个字符

排序字段。枚举值:name,create_user。

sort_dir

string

0~32个字符

排序方向。枚举值:desc 和asc,默认值:asc。

api_path

string

0~512个字符

请求path

request_type

string

0~32个字符

API 协议类型

project_id

string

0~64个字符

项目ID

请求

  • 请求header参数

    请参见请求示例中header描述。

  • 请求body参数

  • 请求示例
    GET /rest/gaia/dataapi/v1/api/querylist?start=xxx&limit=xxx&name=xxx&full_name=xxx&catalog_id=xxx&catalog_parent_id=xxx&api_status=xxx&api_debug=xxx&start_time=xxx&end_time=xxx&create_user=xxx&sort_key=xxx&sort_dir=xxx&api_path=xxx&request_type=xxx&project_id=xxx HTTP/1.1 
    Host: example.com 
    Content-Type: application/json 
    Accept: application/json

响应

  • 响应参数
    • 响应状态码200:返回ApiListResponse。
      表3 ApiListResponse对象属性

      参数

      是否必选

      类型

      值域

      说明

      api_list

      表4

      API集合

      api_total

      int32

      默认值:0

      API总数

      catalog_list

      表5

      目录集合

      catalog_total

      int32

      默认值:0

      目录总数

      表4 ApiVo对象属性

      参数

      是否必选

      类型

      值域

      说明

      id

      string

      API ID

      name

      string

      API名称

      description

      string

      API描述

      api_path

      string

      API URL

      api_type

      string

      API类型:new(新建API),exist(注册已有API,预留)

      api_protocol_type

      string

      API 协议类型:HTTPS HTTP

      request_type

      string

      API 请求类型,GET,POST

      create_time

      int64

      创建时间

      update_time

      int64

      更新时间

      publish_time

      int64

      更新时间

      project_id

      string

      所属项目

      released

      int32

      API发布标识

      successful_test

      int32

      API调试标识

      service_type

      int32

      单数据源或多数据源

      auth_type

      string

      认证类型:IAM

      create_user

      string

      创建用户

      approve_user_id

      string

      审核人

      update_user

      string

      更新用户

      api_status

      int32

      状态:1等待发布审批,2发布请求拒绝,3已发布,4下线拒绝,5等待下线审批,8待发布,7发布失败,6下线失败

      api_debug

      int32

      API调试标识:0等待调试,1调试失败,2调试成功

      body

      string

      body体(虽然为text,但是长度限制在20480,这个和apig保持一致)

      retention_period

      int64

      API最小保留期,预留

      catalog_id

      string

      所属目录id

      security_level

      string

      密级

      owner_name

      string

      owner_name

      project_name

      string

      project_name

      connection_type

      string

      connection_type

      表5 ApiCatalogVo对象属性

      参数

      是否必选

      类型

      值域

      说明

      id

      string

      ID

      name

      string

      name

      description

      string

      description

      create_time

      int64

      create_time

      create_user

      string

      create_user

      create_user_id

      string

      create_user_id

      update_time

      int64

      update_time

      update_user

      string

      update_user

      project_id

      string

      project_id

      parent_id

      string

      parent_id

      owner_name

      string

      owner_name

      project_name

      string

      project_name

  • 响应示例
    HTTP/1.1 200 OK 
    Date:Wed,19 Jul 2023 14:15:28 GMT 
    Server: example.com 
    Content-Type: application/json;charset=UTF8

状态码

表6 状态码

状态码

说明

200

操作成功。

400

参数错误。

403

鉴权失败。

404

接口没找到。

500

默认ServiceException异常码,应用内部错误。

操作危险级别

Minor

相关文档