Request Structure

Last updated: 2017-07-25 11:06:28

    The process of calling Tencent Cloud APIs is achieved by sending requests to the server IP addresses of these APIs and adding relevant request parameters in the requests as described in the API descriptions. A request for calling Tencent Cloud API is made up of the following elements:

    1. Service Address

    The service connection address of Tencent Cloud APIs depends on the modules. For more information, please see the descriptions of each API.

    2. Communication Protocol

    Most Tencent Cloud APIs communicate over HTTPS to provide high-security channels.

    3. Request Methods

    Tencent Cloud APIs support both POST and GET requests.

    1. The two methods cannot be used at the same time. If GET method is used, parameters are obtained from Querystring. If POST method is used, parameters are obtained from Request Body, and the parameters in Querystring will be ignored. The rules for parameter formats are the same for both methods. Generally, GET method is used. If the parameter strings are too long, POST method is used.
    2. If GET method is used, all request parameters need to be encoded with URL encoding. This is not needed if POST method is used.**

    4. Request Parameters

    Two types of parameters are required for each Tencent Cloud API request - common request parameters and API request parameters. Common request parameters are the parameters common to all APIs (For more information, please see [Common Request Parameters](/doc/api/255/Common Request Parameters) section), while API request parameters are parameters specific to each API (For more information, please see "Request Parameters" description of each API.)

    5 Character Encoding

    All requests for Tencent Cloud APIs and their returned results are encoded using UTF-8 character set.

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback