查询API版本信息

功能介绍

查询指定API版本信息。

URI

URI格式

GET /{version}

请求消息

• 请求头

  GET https://DDS的Endpoint/{version}

• 请求体

  N/A

响应消息

• 要素说明

  表1 要素说明

  名称	参数类型	描述
  version	Object	API版本详细信息列表。详情请参见表2。

  表2 version字段数据结构说明

  名称	参数类型	描述
  id	String	API版本号。
  links	Array of objects	对应该API版本的链接信息。详情请参见表3。 说明： v3版本该字段为[]。
  status	String	版本状态。取值为“CURRENT”，表示该版本目前已对外公布。
  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为本地链接。

• 响应样例

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

状态码

详情请参见状态码。

错误码

详情请参见错误码。