tencent cloud

文档反馈

CreateAccount

最后更新时间:2024-12-18 14:30:41

    1. API Description

    Domain name for API request: intlpartnersmgt.intl.tencentcloudapi.com.

    This API is used to create Tencent Cloud customer accounts for distributor/second-level resellers.After the account is created, it will be automatically bound to the partner account.Note:

    1. Create a Tencent Cloud account. The entered email address and mobile phone number need to be verified by the partner for validity.
    2. Customers need to add personal information when logging in for the first time.
    3. This interface needs to be applied for allowlist usage. Please contact the channel manager to initiate the application process.

    A maximum of 5 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: 2022-09-28.
    Region No String Common Params. This parameter is not required.
    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.
    such as "account@qq.com"
    Password Yes String Account password.
    Length limit: 8-20 characters
    A password must contain numbers, letters, and symbols (!@#$%^&*()). Space is not allowed.
    ConfirmPassword Yes String The confirmed password, which must be the same as that entered in the Password field.
    PhoneNum Yes String Customer's mobile number.
    The caller needs to ensure the validity and correctness of the mobile number. A global mobile number within a range of 1-32 digits is allowed.
    The system will perform binding limit verification of the mobile number you provide, allowing a maximum of 5 accounts per mobile number.
    CountryCode Yes String Customer's country/region code, which can be obtained via the GetCountryCodes API, such as "852".
    Parameter value is not allowed to be 7,380,86.
    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 Extension field, which is left empty by default.
    VerifyCode No String VerifyCode. This field is required.
    Use the SendVerifyCode API to obtain the verifycode.The SendVerifyCode API sends a 6-digit verifycode to your specified mobile number via SMS. After receiving it, you need to pass it along with other parameters.

    3. Output Parameters

    Parameter Name Type Description
    Uin String Account UIN
    RequestId String The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

    4. Example

    Example1 Applying to create a customer account

    Applying to create a customer account

    Input Example

    POST / HTTP/1.1
    Host: intlpartnersmgt.intl.tencentcloudapi.com
    Content-Type: application/json
    X-TC-Action: CreateAccount
    <Common request parameters>
    
    {
        "Extended": "for personal",
        "CountryCode": "852",
        "Area": "HK",
        "PhoneNum": "18888888888",
        "AccountType": "business",
        "Mail": "account@qq.com",
        "Password": "ABCabc123!",
        "ConfirmPassword": "ABCabc123"
    }
    

    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.
    FailedOperation.ExceedMaxBindCount
    FailedOperation.MailIsRegistered FailedOperation.MailIsRegistered
    FailedOperation.PhoneBindUpper The number of registered accounts for the current mobile number has reached the maximum limit. Please change the phone number and try again.
    FailedOperation.VerificationCodeIllegal Incorrect verification code.
    InternalError Internal error.
    InvalidParameter.AccountTypeContentIncorrect InvalidParameter.AccountTypeContentIncorrect
    InvalidParameter.AreaContentIncorrect InvalidParameter.AreaContentIncorrect
    InvalidParameter.AreaFormatIncorrect InvalidParameter.AreaFormatIncorrect
    InvalidParameter.ConfirmPasswordContentIncorrect InvalidParameter.ConfirmPasswordContentIncorrect
    InvalidParameter.CountryCodeContentIncorrect InvalidParameter.CountryCodeContentIncorrect
    InvalidParameter.CountryCodeFormatIncorrect InvalidParameter.CountryCodeFormatIncorrect
    InvalidParameter.MailFormatIncorrect InvalidParameter.MailFormatIncorrect
    InvalidParameter.PasswordContentIncorrect InvalidParameter.PasswordContentIncorrect
    InvalidParameter.PasswordFormatIncorrect InvalidParameter.PasswordFormatIncorrect
    InvalidParameter.PhoneNumFormatIncorrect InvalidParameter.PhoneNumFormatIncorrect
    InvalidParameterValue.AccountTypeEmpty InvalidParameterValue.AccountTypeEmpty
    InvalidParameterValue.AreaEmpty InvalidParameterValue.AreaEmpty
    InvalidParameterValue.CountryCodeEmpty InvalidParameterValue.CountryCodeEmpty
    InvalidParameterValue.MailEmpty InvalidParameterValue.MailEmpty
    InvalidParameterValue.PasswordEmpty InvalidParameterValue.PasswordEmpty
    InvalidParameterValue.PhoneNumEmpty InvalidParameterValue.PhoneNumEmpty
    InvalidParameterValue.UnSupportArea The current region does not support creating a Tencent Cloud International account.
    UnauthorizedOperation Unauthorized operation.