更新时间:2022-12-05 GMT+08:00

获取服务API版本列表

功能介绍

获取服务API版本列表,无需认证

URI

GET /

请求参数

响应参数

状态码: 200

表1 响应Body参数

参数

参数类型

描述

versions

Array of Version objects

服务的API版本信息列表

表2 Version

参数

参数类型

描述

id

String

API版本ID,如v1

最小长度:1

最大长度:128

version

String

API的最大微版本号,不支持固定填空

最小长度:1

最大长度:128

min_version

String

API的最小微版本号,不支持固定填空

最小长度:1

最大长度:128

status

String

API版本状态

  • 取值:

    • CURRENT:主推版本

    • SUPPORTED:老版本,仍继续支持

    • DEPRECATED:废弃版本,后续可能会删除

updated

Number

API版本发布UTC时间

最小值:1

最大值:128

links

Array<Object>

API版本URL地址

请求示例

响应示例

状态码: 200

OK

{
  "versions" : [ {
    "id" : "v1",
    "links" : [ {
      "href" : "https://172.32.4.1:8331/v1",
      "rel" : "self"
    } ],
    "vesion" : "",
    "min_version" : "",
    "status" : "SUPPORTED",
    "updated" : "2018-02-12 02:12:12"
  }, {
    "id" : "v2",
    "links" : [ {
      "href" : "https://172.32.4.1:8331/v2",
      "rel" : "self"
    } ],
    "vesion" : "",
    "min_version" : "",
    "status" : "SUPPORTED",
    "updated" : "2018-02-12 02:12:12"
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码