Querying All API Versions

Function

This API is used to query the versions of EPS APIs.

URI

GET /

Request

Example request

GET https://{EPS endpoint}/

You can obtain the EPS service endpoint at Regions and Endpoints.

Before calling an EPS API, you must obtain the domain-level token. For details, see Obtaining the Domain-Level Token.

Response

Parameter description

**Table 1** Parameter in the response
Name	Type	Description
versions	Array	Specifies the list of all versions. For details, see Table 2.

versions field data structure

**Table 2** versions field data structure
Name	Type	Description
id	String	Specifies the version ID, for example, v1.0.
links	List<Link>	Specifies the API URL. For details, see Table 3.
version	String	Specifies the microversion. If the API version supports microversions, the maximum microversion supported is returned. If microversions are not supported, this field is left empty.
status	String	Specifies the version status. The options are as follows: CURRENT: indicates a primary version. SUPPORTED: indicates an old version that is still supported. DEPRECATED: indicates a deprecated version that may be deleted later.
updated	String	Specifies the version release time, which is a UTC time. For example, the release time of v1.0 is 2016-12-09T00:00:00Z.
min_version	String	Specifies the microversion. If the API version supports microversions, the system returns the supported minimum microversion. If microversions are not supported, the system returns an empty value.

Link field data structure

**Table 3** Link field data structure
Name	Type	Description
href	String	Specifies the API URL.
rel	String	self

Example response

{
    "versions": [
        {
            "id": "v1.0",
            "links": [
                {
                    "rel": "self",
                    "href": "https://API URL/v1.0"
                }
            ],
            "version": "",
            "status": "CURRENT",
            "updated": "2016-12-09T00:00:00Z",
            "min_version": ""
        }
    ]
}