Public parameters

Public parameters include public request parameters and public response parameters.

• Public request parameters: the request parameters that every API must use.
• Public response parameters: the parameters returned after an API is called, regardless of whether the call is successful or not.

Public request parameters

The following table lists all the public request parameters for the HiTSDB open APIs.

Public response parameters

The public response parameter for the HiTSDB open APIs is the “RequestId”, a unique identifier. “RequestId” identifies each API call request, and is often used for API troubleshooting.

Example (XML)

<?xml version="1.0" encoding="utf-8"?>
<!—Result root node-->
<Interface name+Response>
    <!—Return request tag-->
    <RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId>
    <!—Returned results-->
    ...
</Interface name+Response>

Returned results

After the API service is called, data is returned in a unified format.

• If the returned HTTP status code is 2xx, the call was successful.
• If the returned HTTP status code is 4xx or 5xx, the call failed.

For successful calls, the commonly used formats of returned data are XML and JSON. When a request is sent, an external system can input parameters to specify the format of the returned data. JSON is recommended.

In this document, examples of returned results are formatted in a way that is easier for users to view. The actual returned results do not contain line breaks, indentation, or other layouts.

Successful results

Returned XML results include the request processing result (successful or failed) and the specific service data.

XML

<?xml version="1.0" encoding="utf-8"?>
<!—Result root node-->
<Interface name+Response>
    <!—Return request tag-->
    <RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId>
    <!—Returned result data-->
    ...
</Interface name+Response>

JSON

{
    /* Returned request ID */
    "RequestId": "4C467B38-3910-447D-87BC-AC049166F216",
    /* Returned results*/
    ...
}

Error results

When an error occurs in an API call, no result is returned. The caller can identify the cause of the error according to the error code.

When an error occurs in a call, the following information is returned for a HTTP request:

• An HTTP status code: 4xx or 5xx;
• A specific error code and error message;
• A globally unique RequestId;
• ID of the site this request accesses: HostId.

If the caller cannot identify the cause of the error, the caller can contact Alibaba Cloud Customer Service and provide the HostId and RequestId to help us solve the problem as quickly as possible.

XML

<?xml version="1.0" encoding="UTF-8"?>
<Error>
   <RequestId>8906582E-6722-409AA6C4-0E7863B733A5</RequestId>
   <HostId>hitsdb.aliyuncs.com</HostId>
   <Code>UnsupportedOperation</Code>
   <Message>The specified action is not supported.</Message>
</Error>

JSON

{
    "RequestId": "7463B73D-35CC-4D19-A010-6B8D65D242EF",
    "HostId": "hitsdb.aliyuncs.com",
    "Code": "UnsupportedOperation",
    "Message": "The specified action is not supported."
}