Request Structure

Last updated: 2019-11-30 15:36:58

    1. Service Address

    The API supports access from either a nearby region (at gaap.tencentcloudapi.com) or a specified region (at gaap.ap-guangzhou.tencentcloudapi.com for Guangzhou, for example).

    We recommend using the domain name to access the nearest server. When you call an API, the request is automatically resolved to a server in the region nearest to the location where the API is initiated. For example, when you initiate an API request in Guangzhou, this domain name is automatically resolved to a Guangzhou server, the result is the same as that of specifying the region in the domain like "gaap.ap-guangzhou.tencentcloudapi.com".

    *Note: For latency-sensitive businesses, we recommend that you specify the region in the domain name. *

    Tencent Cloud currently supports the following regions:

    Hosted region Domain name
    Local access region (recommended, only for non-financial availability zones) gaap.tencentcloudapi.com
    South China (Guangzhou) gaap.ap-guangzhou.tencentcloudapi.com
    East China (Shanghai) gaap.ap-shanghai.tencentcloudapi.com
    North China (Beijing) gaap.ap-beijing.tencentcloudapi.com
    Southwest China (Chengdu) gaap.ap-chengdu.tencentcloudapi.com
    Southwest China (Chongqing) gaap.ap-chongqing.tencentcloudapi.com
    Hong Kong, Macao, Taiwan (Hong Kong, China) gaap.ap-hongkong.tencentcloudapi.com
    Southeast Asia (Singapore) gaap.ap-singapore.tencentcloudapi.com
    Southeast Asia (Bangkok) gaap.ap-bangkok.tencentcloudapi.com
    South Asia (Mumbai) gaap.ap-mumbai.tencentcloudapi.com
    Northeast Asia (Seoul) gaap.ap-seoul.tencentcloudapi.com
    Northeast Asia (Tokyo) gaap.ap-tokyo.tencentcloudapi.com
    U.S. East Coast (Virginia) gaap.na-ashburn.tencentcloudapi.com
    U.S. West Coast (Silicon Valley) gaap.na-siliconvalley.tencentcloudapi.com
    North America (Toronto) gaap.na-toronto.tencentcloudapi.com
    Europe (Frankfurt) gaap.eu-frankfurt.tencentcloudapi.com
    Europe (Moscow) gaap.eu-moscow.tencentcloudapi.com
    Access region for financial availability zone Domain name for financial availability zone
    East China (Shanghai Finance) gaap.ap-shanghai-fsi.tencentcloudapi.com
    South China (Shenzhen Finance) gaap.ap-shenzhen-fsi.tencentcloudapi.com

    2. Communications Protocol

    All the Tencent Cloud APIs communicate via HTTPS, providing highly secure communication tunnels.

    3. Request Methods

    Supported HTTP request methods:

    • POST (recommended)
    • GET

    The Content-Type types supported by POST requests:

    • application/json (recommended). The TC3-HMAC-SHA256 signature algorithm must be used.
    • application/x-www-form-urlencoded. The HmacSHA1 or HmacSHA256 signature algorithm must be used.
    • multipart/form-data (only supported by certain APIs). You must use TC3-HMAC-SHA256 to calculate the signature.

    The size of a GET request packet is up to 32 KB. The size of a POST request is up to 1 MB when the HmacSHA1 or HmacSHA256 signature algorithm is used, and up to 10 MB when TC3-HMAC-SHA256 is used.

    4. Character Encoding

    Only UTF-8 encoding is used.

    Was this page helpful?

    Was this page helpful?

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