tencent cloud

文档反馈

CreateAccount

最后更新时间:2022-09-23 15:40:18

1. API Description

Domain name for API request: ip.tencentcloudapi.com.

This API is used to create a Tencent Cloud account in the International Partner platform for a customer. After registration, the customer will be automatically bound to the partner account.

Notes:

  1. To create the Tencent Cloud account, the partner should enter and verify the customer’s email address and mobile number.
  2. The customer needs to complete personal information after the first login.

A maximum of 20 requests can be initiated per second for this API.

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name Required Type Description
Action Yes String Common Params. The value used for this API: CreateAccount.
Version Yes String Common Params. The value used for this API: 2021-04-09.
Region No String Common Params. This parameter is not required for this API.
AccountType Yes String Account type of a new customer. Valid values: personal, company.
Mail Yes String Registered email address, which should be valid and correct.
For example, account@qq.com.
Password Yes String Account password
Length limit: 8-20 characters
A password must contain numbers, letters, and special symbols [!@#$%^&*()]. Spaces are not allowed.
ConfirmPassword Yes String Confirm the password. It must be the same as the Password field.
PhoneNum Yes String Customer mobile number, which should be valid and correct.
A global mobile number within 1-32 digits is allowed, such as 18888888888.
CountryCode Yes String Customer’s country/region code, which can be obtained via the GetCountryCodes API, such as “852”.
Area Yes String Customer’s ISO2 standard country/region code, which can be obtained via the GetCountryCodes API. It should correspond to the CountryCode field, such as HK.
Extended No String Expanded field, which is left empty by default.

3. Output Parameters

Parameter Name Type Description
Uin String Account UIN
RequestId String The unique request ID, which is returned for each request. RequestId is required for locating a problem.

4. Example

Example1 Creating a customer account and binding it to the reseller account

Input Example

POST / HTTP/1.1
Host: ip.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateAccount
<Common request parameters>

{
    "Extended": "11111111",
    "CountryCode": "852",
    "Area": "HK",
    "PhoneNum": "18888888888",
    "AccountType": "business",
    "Mail": "account@qq.com",
    "Password": "111111",
    "ConfirmPassword": "111111"
}

Output Example

{
    "Response": {
        "Uin": "200000123456",
        "RequestId": "a9e390a7-a1af-42cd-8178-13bd046337a7"
    }
}

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

Command Line Interface

6. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

Error Code Description
AuthFailure CAM signature/authentication error. Please try again later.
FailedOperation.MailIsRegistered The email address has already been registered.
InternalError Internal error. Please try again later.
InvalidParameter.AccountTypeContentIncorrect Incorrect account type.
InvalidParameter.AreaContentIncorrect Incorrect region content.
InvalidParameter.AreaFormatIncorrect Incorrect region format.
InvalidParameter.ConfirmPasswordContentIncorrect Incorrect confirmed password.
InvalidParameter.CountryCodeContentIncorrect Incorrect country/region code content.
InvalidParameter.CountryCodeFormatIncorrect Incorrect country/region code format.
InvalidParameter.MailFormatIncorrect Incorrect email format.
InvalidParameter.PasswordContentIncorrect Incorrect password content.
InvalidParameter.PasswordFormatIncorrect Incorrect password format.
InvalidParameter.PhoneNumFormatIncorrect Incorrect mobile number format.
InvalidParameterValue.AccountTypeEmpty The account type is required and cannot be left empty.
InvalidParameterValue.AreaEmpty The region is required and cannot be left empty.
InvalidParameterValue.CountryCodeEmpty The country/region code is required and cannot be left empty.
InvalidParameterValue.MailEmpty The email is required and cannot be left empty.
InvalidParameterValue.PasswordEmpty The password is required and cannot be left empty.
InvalidParameterValue.PhoneNumEmpty The mobile number is required and cannot be left empty.
UnauthorizedOperation The operation is unauthorized.