Help Center/ ROMA Connect/ API Reference/ Public Resource APIs/ Public Management/ Obtaining the API Version of a Given Version ID
Updated on 2025-03-26 GMT+08:00

Obtaining the API Version of a Given Version ID

Function

This API is used to obtain the API version of a given version ID.

URI

GET /{version}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

version

Yes

String

Version.

Request Parameters

None

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

id

String

API version ID, for example, v1.

version

String

Maximum microversion of the API. This parameter is left blank if the microversion is not supported.

min_version

String

Minimum microversion of the API. This parameter is left blank if the microversion is not supported.

status

String

API version status. The options are as follows:

  • CURRENT: recommended version.

  • SUPPORTED: an old version that is still supported.

  • DEPRECATED: deprecated version, which may be deleted later.

updated

Number

UTC time when the API version was released.

links

links object

URL of the API version.

Example Requests

None

Example Responses

Status code: 200

OK

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

Status Codes

Status Code

Description

200

OK

Error Codes

See Error Codes.