更新时间:2024-10-30 GMT+08:00

获取服务API版本列表

功能介绍

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

URI

GET /

请求参数

响应参数

状态码: 200

表1 响应Body参数

参数

参数类型

描述

versions

Array of Version objects

服务的API版本信息列表。

scene

String

场景信息。

表2 Version

参数

参数类型

描述

id

String

API版本ID,如v1。

version

String

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

min_version

String

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

status

String

API版本状态。取值:

  • CURRENT:主推版本。

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

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

updated

Number

API版本发布UTC时间。

links

links object

API版本URL地址。

请求示例

响应示例

状态码: 200

OK

{
  "versions" : [ {
    "min_version" : "",
    "links" : {
      "rel" : "self",
      "href" : "https://roma.example.com/v1"
    },
    "id" : "v1",
    "updated" : "2018-06-28T12:20:21Z",
    "version" : "",
    "status" : "SUPPORTED"
  }, {
    "min_version" : "",
    "links" : {
      "rel" : "self",
      "href" : "https://roma.example.com/v2"
    },
    "id" : "v2",
    "updated" : "2020-06-28T12:20:21Z",
    "version" : "",
    "status" : "CURRENT"
  } ],
  "scene" : null
}

状态码

状态码

描述

200

OK

错误码

请参见错误码