更新时间:2024-11-05 GMT+08:00
查询API版本列表
功能介绍
查询API版本列表。
接口约束
无
请求参数
无。
请求示例
查询API版本列表。
GET https://{endpoint}/
响应消息
- 正常响应参数说明
参数 |
参数类型 |
描述 |
---|---|---|
versions |
Array of ApiVersion objects |
API版本详细信息列表links |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
API版本号,如v1、v3。 |
links |
Array of LinkInfo objects |
对应API的链接信息,v1、v3版本该字段为空。 |
status |
String |
版本状态。 取值“CURRENT”,表示该版本为主推版本。 取值“SUPPORTED”,表示为老版本,但是现在还继续支持 取值“DEPRECATED”,表示为废弃版本,存在后续删除的可能。 |
version |
String |
若该版本API支持微版本,则填支持的最大微版本号,如果不支持微版本,则填空 |
updated |
String |
版本更新时间。格式为“yyyy-mm-dd Thh:mm:ssZ”。其中,T指某个时间的开始;Z指UTC时间。 |
- 正常响应示例
{ "versions": [ { "id": "v3", "links": [], "status": "CURRENT", "updated": "2019-01-15T12:00:00Z", "version":"" }, { "id": "v1", "links": [], "status": "DEPRECATED", "updated": "2017-02-07T17:34:02Z", "version":"" } ] }
- 异常响应
请参见异常请求结果。
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。
父主题: 查询API版本