Skip to content

Phone Number and Password Login

Interface Address:/v2/enduser/enduserapi/phonePwdLogin

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

Interface Description:Login with phone number and password, returns a token

Request Parameters:

Parameter NameParameter DescriptionRequest TypeRequiredData Typeschema
phonePhone numberquerytruestring
pwdPasswordquerytruestring
signatureSignature
Signature generation rule: SHA256(internationalCode+phone+pwd+random+userDomainSecret)
querytruestring
userDomainUser domainquerytruestring
internationalCodeInternational code, default is for domesticqueryfalsestring
mccMCCqueryfalseinteger(int32)
randomRandom number used for password encryption and decryption.
Password encryption and decryption rule:
AES128(pwd,MD5(random),initialization vector).
AES encryption convention:
Encryption mode: CBC
Padding: PKCS5Padding
Data block size: 128 bits
Content: pwd
AES key: MD5(random), MD5(random) generates a 16B uppercase string (takes the 8-24 part of the 32-length MD5 string)
Initialization vector: Split the generated AES password (MD5(random)) into two 8B byte data groups, reverse them and concatenate to generate new 16B byte data as the offset
Output: BASE64
Character set: utf-8
Example:
pwd: china1234
random: j1acpdj2bmtqZXVb
AES key: 89A049614445CCA8
AES iv: 4445CCA889A04961
After encryption: lkZMvj0KDSJXlp66jBieHA==
After decryption: china1234
queryfalsestring

Response Status:

Status CodeDescriptionschema
200Login successful, token returned in dataRegistration code response data«Login token return»
5002Phone number already registered
5004Phone number not registered
5013User domain format incorrect
5015User domain does not exist
5019Phone number format incorrect
5021Please enter phone number
5022Please enter password
5023Please enter user domain
5028Password incorrect
5056Password format incorrect, please enter 6-20 characters including letters, numbers, or special characters
5104User domain has been disabled
5147Account is frozen, please try again after 20 minutes
5325Due to abnormal behavior from your current network access, there may be security risks. We have temporarily blocked your access, which will be automatically lifted after 24 hours
5420Signature verification failed
5550Please enter signature
5579Phone number or password incorrect, you have 1 more attempt
5580Phone number or password incorrect, you have 2 more attempts
5581Phone number or password incorrect, you have 3 more attempts
5582Phone number or password incorrect, you have 4 more attempts
6084MCC does not belong to the current data center
6085Failed to query data center for MCC

Response Parameters:

Parameter NameParameter DescriptionTypeschema
codeResponse status codeinteger(int32)integer(int32)
dataResponse dataLogin token returnLogin token return
  accessTokenInterface access tokentokentoken
    expirationTimeExpiration timestamp in seconds. Token becomes invalid after this time.integer
    tokentokenstring
  refreshTokenRefresh tokentokentoken
    expirationTimeExpiration timestamp in seconds. Token becomes invalid after this time.integer
    tokentokenstring
extMsgExtended messagestring
msgResponse messagestring

Response Example:

javascript
{
	"code": 0,
	"data": {
		"accessToken": {
			"expirationTime": 0,
			"token": ""
		},
		"refreshToken": {
			"expirationTime": 0,
			"token": ""
		}
	},
	"extMsg": "",
	"msg": ""
}