Request Structure

Last updated: 2019-09-09 11:36:29

1. Service Address

In this product, your API requests are routed to the nearest server via the domain name tke.tencentcloudapi.com. You can also access APIs using the domain name for specified region, such as tke.ap-guangzhou.tencentcloudapi.com for Guangzhou region.

It is recommended to use the domain name for accessing the nearest server. When you call an API, this domain name is automatically resolved to a server in a region nearest to the client 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, with the result same as that of using "tke.ap-guangzhou.tencentcloudapi.com".

Note: For business sensitive to latency, it is recommended to specify domain names containing the region.

The supported domain names are listed as below:

Region Domain Name
Accessing the nearest server (recommended, and is only for non-Finance regions) tke.tencentcloudapi.com
South China (Guangzhou) tke.ap-guangzhou.tencentcloudapi.com
East China (Shanghai) tke.ap-shanghai.tencentcloudapi.com
North China (Beijing) tke.ap-beijing.tencentcloudapi.com
Southwest China (Chengdu) tke.ap-chengdu.tencentcloudapi.com
Southwest China (Chongqing) tke.ap-chongqing.tencentcloudapi.com
Southeast Asia (Hong Kong) tke.ap-hongkong.tencentcloudapi.com
Southeast Asia (Singapore) tke.ap-singapore.tencentcloudapi.com
Asia Pacific (Bangkok) tke.ap-bangkok.tencentcloudapi.com
Asia Pacific (Mumbai) tke.ap-mumbai.tencentcloudapi.com
Asia Pacific (Seoul) tke.ap-seoul.tencentcloudapi.com
Asia Pacific (Tokyo) tke.ap-tokyo.tencentcloudapi.com
Eastern U.S. (Virginia) tke.na-ashburn.tencentcloudapi.com
Western U.S. (Silicon Valley) tke.na-siliconvalley.tencentcloudapi.com
North America (Toronto) tke.na-toronto.tencentcloudapi.com
Europe (Frankfurt) tke.eu-frankfurt.tencentcloudapi.com
Europe (Moscow) tke.eu-moscow.tencentcloudapi.com

Note: Finance regions and non-Finance regions are isolated from each other. Therefore, when you access the services in a finance region (the common parameter Region is finance region), you need to specify a domain name containing the region specified in the Region field.

Finance Region Domain Name
East China (Shanghai Finance) tke.ap-shanghai-fsi.tencentcloudapi.com
South China (Shenzhen Finance) tke.ap-shenzhen-fsi.tencentcloudapi.com

2. Communication Protocol

All the TencentCloud APIs communicate via HTTPS, providing highly secure communications tunnels.

3. Request Methods

Supported HTTP request methods:

  • POST (recommended)
  • GET

Content-Type supported by POST request:

  • application/json (recommended). The TC3-HMAC-SHA256 signature method is required.
  • application/x-www-form-urlencoded. The HmacSHA1 or HmacSHA256 signature method is required.
  • multipart/form-data (supported only in some APIs). The TC3-HMAC-SHA256 signature method is required.

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 method is used, and to 10 MB when TC3-HMAC-SHA256 is used.

4. Character Encoding

UTF-8 encoding is always used.