Querying API Versions

Function

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

URI

GET /

Request

  • Request parameters

    None

  • Example request

    GET /
    

Response

  • Response parameters

    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 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.