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

获取指定版本ID的API版本信息

功能介绍

获取指定版本ID的API版本信息

URI

GET /{version}

表1 路径参数

参数

是否必选

参数类型

描述

version

String

版本

请求参数

响应参数

状态码: 200

表2 响应Body参数

参数

参数类型

描述

version

Version object

版本信息

表3 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

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

状态码

状态码

描述

200

OK

错误码

请参见错误码