更新时间:2022-02-22 GMT+08:00

查询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"
            }
        ]
    }

状态码

详情请参见状态码

错误码

详情请参见错误码