GetUAIDApplyTokenSign

This API provides only the signing function for obtaining an authorization token as part of the UAID retrieval process for China's three major operators.

• To generate the other parameters required to obtain the authorization token, refer to the respective operator's documentation.

• To request the authorization token, refer to the respective operator's documentation. Note that the request must be sent from the user's mobile device over a cellular network.

• After obtaining the authorization token, call the UAIDVerification API to complete the UAID retrieval.

How to request an authorization token

China Mobile (CM)

Protocol: HTTPS + application/json
Method: POST
URL: https://msg.cmpassport.com/h5/getMobile

Request parameters

Request example:

{ "traceId": "mfawsxtcmyplwzpayzzvdvbsowxmkynr", "appId": "300011580392", "sign": "2c61b3c58ffbeed97461e31be4fd931a", "msgId": "redbyxsdetddwaaffajcwwapspykftzx", "expandParams": "", "businessType": "3", "version": "1.0", "timestamp": "20201125101540980" }

Parameter description:

• version: Use 1.0.

• timestamp: The request timestamp, with millisecond precision. This value and its format must match the Time input parameter for this API.

• appId: Use 300011580392.

• businessType: Use 3.

• traceId: The trace ID. This value must match this API's OutId input parameter.

• sign: Obtained by calling this API.

• msgId: A unique message identifier.

Response parameters

Response example:
{ "header": { "appId": "300011580392", "msgId": "redbyxsdetddwaaffajcwwapspykftzx", "timestamp": "20201125101607932" }, "body": { "resultCode": "103000", "expandParams": "", "resultDesc": "成功", "token": "H5HTTPS4187AE9743AFCB14F8D99B9D65ED9E01" } }

Retrieve the token from the response body.

China Unicom (CU)

Obtain the token in two steps.

Step 1: Obtain the authurl

Send a request to the portal server to get the authentication server address (authurl).

Protocol: HTTPS + application/json
Method: GET
URL: https://nisportal.10010.com:9001/api

Request parameters

Request examples:
JSON request: ?appid=1554778161153
JSONP request: ?appid=1554778161153&callback=callbackFunction

Parameter description:

• appid: Use 1554778161153.

• callback: The name of the JSONP callback function. This parameter is required only for JSONP requests.

Response parameters

Response examples:
JSON response: {"authurl": "https://enrichgw.10010.com/d93222629f52ec79"}
JSONP response: callbackFunction({"authurl":"https://enrichgw.10010.com/d93222629f52ec79"})

Retrieve the authurl from the response.

Step 2: Obtain the token

Protocol: HTTPS + application/json
Method: GET
URL: The authurl from Step 1, with /api appended.

Request URL example: https://enrichgw.10010.com/d93222629f52ec79/api

Request parameters

Request examples:
JSON request: ?appid=1554778161153
JSONP request: ?appid=1554778161153&callback=callbackFunction

Parameter description:

• appid: Use 1554778161153.

• callback: The name of the JSONP callback function. This parameter is required only for JSONP requests.

Response parameters

Response examples:
JSON response: { "province": "1", "code": "7nHS1nggx2WP613750206700RN6oiRN1" }
JSONP response: callbackFunction({"province":"1","code":"7nHS3Dnkd1BS701851092400RN6oiRN1"})

Retrieve the code from the response.

China Telecom (CT)

Protocol: HTTPS + application/x-www-form-urlencoded;charset=UTF-8
Method: GET
URL: https://id6.me/gw/preuniq.do

Request parameters

Request example:
?clientType=30100&appId=9390188202&format=json&sign=D63C166FA19E1996EF********09C6A5397C10B4&paramKey=1D7C25EB8B0B8B4CB3CF8DC60628F6549********786B0AF1FEF93FA1335057A35BF5F0B39A3867EAA9BE14B3898********8B01DE34965060445B6E1F66401D714650E4AB161CD6DCF4A72********3B856F22A192B8B0C39D7A55B961062E68C89C928894F119B25********7C548355FE9DB82852EB93C939F2200B48CD17&paramStr=140********95AF8E138B94754CB4CF83BA6FB********52B258BFDFD38BF233&version=1.1

Parameter description:

• appId: Use 9390188202.

• clientType: The client type. This value must match the ClientType input parameter for this API.

• format: Use json or jsonp.

• version: Use 1.1.

• sign: Obtained by calling this API.

• paramKey: The ciphertext of key A. Key A is a 16-character random string generated by the client. To generate paramKey, encrypt key A using the RSA algorithm and the China Telecom public key. The padding mode is RSA/ECB/PKCS1Padding. Download the China Telecom RSA public key.

• paramStr: The ciphertext of a parameter string. This string contains timeStamp (a Unix timestamp with millisecond precision, for example 1697791988302, that corresponds to the value of the Time parameter of this API) and callback (the name of the JSONP callback function, required only when format is set to jsonp). To generate paramStr, encrypt the string using AES with key A. The padding mode is AES/CBC/PKCS5Padding, and the initialization vector is 0000000000000000.

Response parameters

Response example:
callback?result=10000&msg=success&data=a35336711c70456cb883f4f224e9a259

The data parameter contains the ciphertext of the business result. To get the result, decrypt the data value using key A, the AES/CBC/PKCS5Padding mode, and an initialization vector of 0000000000000000.

Decrypted business result example:
{"accessCode": "H5HTTPS4187AE9743AFCB14F8D99B9D65ED9E01"}

Retrieve the accessCode from the decrypted result.