Files

Reviewed-by: Gladkov, Maksim <mgladkov@noreply.gitea.eco.tsi-dev.otc-service.com>
Co-authored-by: wangdengke2 <wangdengke2@huawei.com>
Co-committed-by: wangdengke2 <wangdengke2@huawei.com>

2025-12-11 08:38:23 +00:00

11 KiB

Raw Blame History

Querying Version Information of an API

Function

This API is used to query version information of a specified API.

URI

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

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
version	Yes	String	API version

Request Parameters

None

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
version	ApiVersionResponse object	API version information

**Table 3** ApiVersionResponse
Parameter	Type	Description
id	String	API version number
links	Array of Links objects	API link information NOTE: If the version is v3, the value is [].
status	String	Version status
version	String	Subversion information of the API version
min_version	String	Minimum API version number
updated	String	Version update time The format is yyyy-mm-dd Thh:mm:ssZ. T is the separator between the calendar and the hourly notation of time. Z indicates the UTC.

**Table 4** Links
Parameter	Type	Description
href	String	API URL. The value is "".
rel	String	The value is self, indicating that URL is a local link.

Example Requests

URI example

GET https://{Endpoint}/v3

Example Responses

Status code: 200

Successful response

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

Status Codes

See Status Codes.

Error Codes

See Error Codes.

Parent topic: API Versions

11 KiB Raw Blame History