Listing All SMN API Versions

Description

• API name

  QueryApiSupportVersions

• Function

  List all SMN API versions.

URI

• URI format

  GET /

Request

• Request example

  GET https://{SMN_Endpoint}/

Response

• Parameter description

  Parameter	Type	Description
  versions	Versions structure	Version object list. For details, see Table 1.

  Table 1 Versions structure

  Parameter	Type	Description
  id	String	Version number, for example, v2
  min_version	String	Minimum micro-version number. If the APIs do not support micro-versions, no information will be returned.
  status	String	Version status, which can be the following: CURRENT: widely used version SUPPORTED: earlier version, which is still supported DEPRECATED: deprecated version, which may be deleted later
  updated	String	Version release time, which must be UTC time. For example, the release time of v2 is 2014-06-28T12:20:21Z.
  version	String	Maximum micro-version number. If the APIs do not support micro-versions, no information will be returned.
  links	Links structure array	URL of an API. For details, see Table 2.

  Table 2 Links structure

  Parameter	Type	Description
  href	String	Shortcut link
  rel	String	Shortcut link marker name

• Response example

  {
      "versions": [
          {
              "id": "v2",
              "links": [
                  {
                      "href": "https://127.0.0.1/v2",
                      "rel": "self"
                  }
              ],
              "min_version": "",
              "status": "CURRENT",
              "updated": "2018-09-19T00:00:00Z",
              "version": ""
          }
     ]
  }

Returned Value

See section Returned Value.

Error Code

See section Error Code.