Register Process

The registration system supports multiple registration methods, including email/mobile phone number registration and third-party registration services.

Feature

• Email/Phone Number Registration: Users can choose to register with either an email address or a phone number.

• Third-Party Registration: Support for registration via Google, Facebook, Twitter, Telegram, Apple, and MetaMask.

Relevant Interfaces

1. Registration Interface

   • Endpoint: /register/customer.app.CustomerWebApiService.register

   • Function: Handles user registration requests.

2. Get Country List Interface

   • Endpoint: /config.app.AppDictDubboService.getCountryListByParentCode

   • Function: Retrieves the list of countries and regions for users to select country codes during registration.

3. Check Customer Status Interface

   • Endpoint: /cats-gateway/global/customer.app.CustomerWebApiService.checkStatus

   • Function: Checks the customer's status to ensure user information does not already exist.

4. Send Verification Code Interface

   • Endpoint: /global/message.app.VerificationApiService.verifyCodeSend

   • Function: Sends a verification code to the user for email or phone number registration verification.

Interface Usage Instructions

Before calling the interfaces, please ensure you have carefully read the relevant interface documentation. Below are specific instructions for different registration methods:

1.Email Registration

1. Verify Customer Information

   • Use the customer information verification interface to ensure that the account does not already exist before proceeding.

   • {
       // User login name, supports email or phone number format
       "loginName": "[email protected]"                 
     }
     

2. Send Verification Code

   • Call the send verification code interface to receive a successful verification code ticket (sendToken).

   • {
       // Business type: EMAIL_REGISTER_VERIFICATION_CODE for email registration,
       // SMS_REGISTER_VERIFICATION_CODE for SMS registration
       "bizType": "EMAIL_REGISTER_VERIFICATION_CODE",
     
       // User recipient: phone numbers should include country code, e.g., "[phone]",
       // or an email address, e.g., "[email protected]"
       "toUser": "[email protected]"                     
     }
     

3. Complete Registration

   • Use the registration interface, passing in loginName, type, sendToken, and verifyCode parameters. Refer to the interface documentation for specific parameter descriptions.

   • {
       // User registration name: email
       "loginName": "[email protected]",              
     
       // Registration type: 1 for email registration
       "type": 1,                                            
     
       // Verification code ticket: obtained after sending the verification code, used for verification
       "sendToken": "ac233902-e270-4c23-98b1-c10f431b1474", 
     
       // Verification code: user-entered code to complete registration
       "verifyCode": "452330"                
     }
     

• Notes:

  • Account Verification: Before sending the verification code, confirm that the account does not already exist to ensure unique user registration information.

  • Verification Code Ticket: The sendToken parameter is the ticket returned after successfully sending the verification code and is used to verify the code's validity.

2.Phone Number Registration

1. Get Country Code Data

   • Use the country list interface to retrieve country code data.

2. Verify Customer Information

   • Use the customer information verification interface to ensure that the account does not already exist before proceeding.

   • {
       // User login name: phone number
       "loginName": "68423752",              
     
       // Login type: 2 for phone number registration
       "type": 2                             
     }
     

3. Send Verification Code

   • Call the send verification code interface to receive a successful verification code ticket (sendToken).

   • {
       // Business type: EMAIL_REGISTER_VERIFICATION_CODE for email registration,
       // SMS_REGISTER_VERIFICATION_CODE for SMS registration
       "bizType": "SMS_REGISTER_VERIFICATION_CODE",
     
       // User recipient: phone numbers should include country code, e.g., "[phone]",
       // or an email address, e.g., "[email protected]"
       "toUser": "[phone]"                   
     }
     

4. Complete Registration

   • Use the registration interface, passing in loginName, type, phoneArea, sendToken, and verifyCode parameters. Refer to the interface documentation for specific parameter descriptions.

   • {
       // User registration name: phone number
       "loginName": "68423752",              
     
       // Registration type: 2 for phone number registration
       "type": 2,                                            
     
       // Verification code ticket: obtained after sending the verification code, used for verification
       "sendToken": "ac233902-e270-4c23-98b1-c10f431b1474", 
     
       // Verification code: user-entered code to complete registration
       "verifyCode": "452330",   
     
       // Country code: e.g., "+852", to ensure correct phone number format
       "phoneArea": "+852"                  
     }
     

• Notes:

  • Account Verification: Before sending the verification code, confirm that the account does not already exist to ensure unique user registration information.

  • Verification Code Ticket: The sendToken parameter is the ticket returned after successfully sending the verification code and is used to verify the code's validity.