文档首页/ 应用与数据集成平台 ROMA Connect/ API参考/ 公共资源API/ 公共管理/ 获取服务API版本列表
更新时间：2024-10-30 GMT+08:00
在线调试
CLI示例
查看PDF
分享

获取服务API版本列表

功能介绍

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

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

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地址。
表3 links

参数

参数类型

描述

rel

String

用途。

href

String

该用途的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

错误码

请参见错误码。

父主题： 公共管理

相关文档