Help Center/ Dedicated Host/ API Reference/ API/ API Version Query/ Querying an API Version

Updated on 2024-04-16 GMT+08:00

View PDF

Querying an API Version

Function

This API is used to query a specified API version.

URI

GET /{api_version}

Table 1 describes the parameters.

**Table 1** Parameters description
Parameter	Mandatory	Description
api_version	Yes	Specifies the API version, for example, v1.0.

Request

None

Response

**Table 2** Response parameters
Parameter	Type	Description
version	Object	Specifies information about a specified API version.

**Table 3** **version** field description
Parameter	Type	Description
id	String	Specifies the ID of the API version.
links	Array of objects	Specifies the URL of the API version.
min_version	String	Specifies the microversion. If the APIs of this version support micro-versions, set this parameter to the supported minimum micro-version. If the microversion is not supported, leave this parameter blank.
status	String	Specifies the API version status. CURRENT: indicates a primary version. SUPPORTED: indicates an earlier version which is still supported. DEPRECATED: indicates a deprecated version which may be deleted later.
updated	String	Specifies the API version update time.
version	String	If the APIs of this version support micro-versions, set this parameter to the maximum micro-version supported. If not, leave this parameter blank.

**Table 4** **links** field description
Parameter	Type	Description
href	String	Specifies the URL of the API version.
rel	String	Specifies the API URL dependency.

Example Request

Query the information about API v1.0 of DeH.

GET /v1.0

Example Response

{
    "version": {
        "id": "v1.0",
        "links": [
            {
                "href": "https//deh.xxx.com/v1.0/",
                "rel": "self"
            }
        ],
        "min_version": "",
        "status": "SUPPORTED",
        "updated": "2016-12-01T11:33:21Z",
        "version": ""
    }
}