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

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

View PDF

Querying API Versions

Function

This API is used to query all API versions available to the DeH service.

URI

GET /

Request

None

Response

**Table 1** Response parameters
Parameter	Type	Description
versions	Array of objects	Specifies the API versions.

**Table 2** **versions** 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, which must be UTC 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 3** **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 all available API versions of DeH.

GET /

Example Response

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