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": ""
        }
    ]
}

Status Code¶

See Status Codes.

last updated: 2024-11-13 13:43 UTC - commit: 22051be0c84e6642838cd57e0ebcbbcd9d5da408