Help Center/ Data Admin Service/ API Reference/ APIs (in OBT)/ API Version Queries/ Querying a Specified API Version
Updated on 2025-05-19 GMT+08:00
View PDF
Share

Querying a Specified API Version

Function

This API is used to query a specified API version.

URI

GET /das/{version}

Table 1 URI parameter

Parameter

Mandatory

Type

Description

version

Yes

String

Explanation:

API version

Constraints:

N/A

Values:

N/A

Default value:

N/A

Request Parameters

None

Response Parameters

Status code: 200

Table 2 Response body parameter

Parameter

Type

Description

version

ApiVersion object

Explanation:

API version details

Values:

N/A
Table 3 ApiVersion

Parameter

Type

Description

id

String

Explanation:

API version, for example, v3

Values:

N/A

status

String

Explanation:

Version status

Values:

  • CURRENT: The current version is recommended.
  • SUPPORTED: The current version is supported.
  • DEPRECATED: The current version is deprecated and may be deleted later.

updated

String

Explanation:

Version release time in the format of yyyy-mm-ddThh:mm:ssZ T is the separator between the calendar and the hourly notation of time. Z indicates the Coordinated Universal Time (UTC).

Values:

N/A

version

String

Explanation:

API microversion. If the APIs do not support microversions, the value is left blank.

Values:

N/A

Example Request

This API is used to query a specified API version.

Example Responses

Status code: 200

Successful request

{
  "version" : {
    "id" : "v3",
    "version" : "",
    "status" : "CURRENT",
    "updated" : "2021-01-15T12:00:00Z"
  }
}

Status Code

Status Code

Description

200

Successful request

Error Code

For details, see Error Codes.

Parent topic: API Version Queries