查询API版本列表
功能介绍
查询标签管理服务的API版本列表。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /
请求参数
无
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
versions |
Array of VersionDetail objects |
版本列表 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
版本ID(版本号),如v1.0。 |
links |
Array of Link objects |
API的URL地址。 |
version |
String |
若该版本API支持微版本,则返回支持的最新微版本号,如果不支持微版本,则返回空。 |
status |
String |
版本状态,为如下3种: CURRENT:表示该版本为主推版本。 SUPPORTED:表示为老版本,但是现在还继续支持。 DEPRECATED:表示为废弃版本,存在后续删除的可能。 |
updated |
String |
版本发布时间,采用UTC时间表示。如v1.0发布的时间2016-12-09T00:00:00Z。 |
min_version |
String |
若该版本API 支持微版本,则返回支持的最早微版本号, 如果不支持微版本,则返回空。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error |
RespErrorMessage object |
响应错误信息 |
状态码: 404
参数 |
参数类型 |
描述 |
---|---|---|
error |
RespErrorMessage object |
响应错误信息 |
状态码: 405
参数 |
参数类型 |
描述 |
---|---|---|
error |
RespErrorMessage object |
响应错误信息 |
状态码: 406
参数 |
参数类型 |
描述 |
---|---|---|
error |
RespErrorMessage object |
响应错误信息 |
状态码: 409
参数 |
参数类型 |
描述 |
---|---|---|
error |
RespErrorMessage object |
响应错误信息 |
状态码: 410
参数 |
参数类型 |
描述 |
---|---|---|
error |
RespErrorMessage object |
响应错误信息 |
状态码: 412
参数 |
参数类型 |
描述 |
---|---|---|
error |
RespErrorMessage object |
响应错误信息 |
状态码: 429
参数 |
参数类型 |
描述 |
---|---|---|
error |
RespErrorMessage object |
响应错误信息 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error |
RespErrorMessage object |
响应错误信息 |
状态码: 501
参数 |
参数类型 |
描述 |
---|---|---|
error |
RespErrorMessage object |
响应错误信息 |
状态码: 503
参数 |
参数类型 |
描述 |
---|---|---|
error |
RespErrorMessage object |
响应错误信息 |
请求示例
查询标签管理接口版本号列表
GET https://{Endpoint}/
响应示例
状态码: 200
OK
{ "versions" : [ { "id" : "v1.0", "links" : [ { "rel" : "self", "href" : "https://{Endpoint}/v1.0" } ], "version" : "", "status" : "CURRENT", "updated" : "2016-12-09T00:00:00Z", "min_version" : "" } ] }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Bad Request |
404 |
Not Found |
405 |
Method Not Allowed |
406 |
Not Acceptable |
409 |
Conflict |
410 |
Gone |
412 |
Precondition Failed |
429 |
Too Many Requests |
500 |
Internal Server Error |
501 |
Not Implemented |
503 |
Service Unavailable |
错误码
请参见错误码。