接口描述

本接口(DescribeApisStatus)用于查看一个服务下的某个 API 或所有 API 列表及其相关信息。

输入参数

以下请求参数列表仅列出了接口请求参数,其它参数可参考 公共请求参数

参数名称 是否必选 类型 描述
serviceId String API 所在的服务唯一 ID。
apiIds.n String API 接口唯一 ID 数组。
offset Int 偏移量,默认为 0。
limit Int 返回数量,默认为 20,最大值为 100。
orderby String 根据哪个字段排序。
order String 排序方式。
searchName String 按照 API 路径名字模糊搜索。
searchId String 按照 API 唯一 ID 精确搜索。

输出参数

参数名称 类型 描述
code Int 公共错误码, 0 表示成功,其他值表示失败。详见错误码页面的 公共错误码
codeDesc String 业务侧错误码。成功时返回 Success,错误时返回具体业务错误原因。
message String 模块错误信息描述,与接口相关。
serviceId String API 所在的服务唯一 ID。
totalCount Int 符合条件的 API 接口数量。
apiIdStatusSet List of Array API 接口列表。

其中,apiIdStatusSet 是 apiIdStatus 构成的数组,apiIdStatus 的构成如下:

参数名称 类型 描述
apiId String API 接口唯一 ID。
apiDesc String 用户自定义的 API 接口描述。
apiName String API 接口的名称。
apiType String API 接口的类型,当前只有 NORMAL,后续还会增加其他类型的 API。
path String API 请求 path。
method String API 请求方式。
createdTime Timestamp 创建时间。按照 ISO8601 标准表示,并且使用 UTC 时间。格式为:YYYY-MM-DDThh:mm:ssZ。
modifiedTime Timestamp 最后修改时间。按照 ISO8601 标准表示,并且使用 UTC 时间。格式为:YYYY-MM-DDThh:mm:ssZ。
authRequired String 是否需要签名认证,TRUE 表示需要,FALSE 表示不需要。

示例

查询一个后端是 HTTP 服务的 API 接口的详细信息:

请求示例如下:

  1. https://apigateway.api.qcloud.com/v2/index.php?
  2. &<公共请求参数>
  3. &Action=DescribeApisStatus
  4. &serviceId=service-XX
  5. &apiIds.0=api-XX
  6. &apiIds.1=api-XXX
  7. &offet=0
  8. &limit=2
  9. &orderby=createdTime
  10. &order=desc
  11. &searchKey=aa

返回示例如下:

  1. {
  2. "code":"0",
  3. "message":"",
  4. "codeDesc":"Success",
  5. "serviceId":"service-XX",
  6. "totalCount":2,
  7. "apiIdStatusSet":[
  8. {
  9. "apiId":"api-XX",
  10. "apiName":"apiXXXX",
  11. "apiType":"NORMAL",
  12. "apiDesc":"apiDescription1",
  13. "path":"path1",
  14. "method":"http",
  15. "serviceId":"serviceId-XXX",
  16. "createdTime":"2017-08-07T00:00:00Z",
  17. "modifiedTime":"2017-08-07T00:00:00Z",
  18. "authRequired":"TRUE"
  19. },
  20. {
  21. "apiId":"api-XXX",
  22. "apiName":"apiXXXX",
  23. "apiType":"NORMAL",
  24. "apiDesc":"apiDescription2",
  25. "path":"path2",
  26. "method":"https",
  27. "serviceId":"serviceId-XXXX",
  28. "createdTime":"2017-08-07T00:10:00Z",
  29. "modifiedTime":"2017-08-07T00:10:00Z",
  30. "authRequired":"TRUE"
  31. }
  32. ]
  33. }