查询API版本列表

功能介绍

查询当前支持的API版本信息列表。

URI

• URI格式

  GET /

• 参数说明

  N/A

请求消息

• 请求头

  GET https://DDS的Endpoint/

• 请求体

  N/A

响应消息

• 要素说明

  表1 要素说明

  名称	参数类型	描述
  versions	Array of objects	API版本详细信息列表。详情请参见表2。

  表2 versions字段数据结构说明

  名称	参数类型	描述
  id	String	API版本号。
  links	Array of objects	对应该API的链接信息。详情请参见表3。 说明： v3版本该字段为[]。
  status	String	版本状态。
  version	String	API版本的子版本信息。
  min_version	String	API版本的最小版本号。
  updated	String	版本更新时间。 格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始，Z指UTC时间。

  表3 links字段数据结构说明

  名称	参数类型	描述
  href	String	对应该API的URL，该字段为""。
  rel	String	取值为“self”，表示URL为本地链接。

• 响应样例

  {
      "versions": [
          {
              "id": "v3",
              "links": [],
              "status": "CURRENT",
              "version": "",
              "min_version": "",
              "updated": "2017-02-07T17:34:02Z"
          }
      ]
  }

状态码

详情请参见状态码。

错误码

详情请参见错误码。