QR Master
1.Overview
Remote unlock (gateway remote room unlock, WiFi remote access control, WiFi remote elevator control).
II. Request Method
III. Parameter Description
| Attribute | Type | Constraint | Explanation |
|---|---|---|---|
| accountSid | String | Required | Account ID (accountSid and authToken are assigned by Lock Manager when applying for developer account) |
| timestamp | String | Required | Request timestamp |
| communityNo | String | Required | Community No. |
| lockType | String | Required | 远程Type(1: Gateway remote room unlock; 2: WiFi remote access control; 3: WiFi remote elevator control) |
| mac | String | Required | Room lock MAC address |
| boxId | String | Optional | Gateway ID(Required when lockType is 1) |
| floorNum | String | Optional | Floor No.(Required when lockType is 3) |
IV. Request URL
V. Generate Parameter Signature
Ⅰ. Add authToken parameter to POST key-value pairs (accountSid and authToken are assigned by Lock Manager when applying for developer account) to obtain original signature data.
Ⅱ. Sort the original signature data in dictionary order by parameter name.
Ⅲ.Joining together into a string like "key1=value1&key2=value2...". The key/value shall be encoded in x-www-form-urlencode.
Ⅳ. Calculate the SHA1 value of the string to obtain the parameter signature sig.
Note: this authToken should not be submitted to the network with the POST parameter.
VI. Request Example (Raw)
POST http://api.uclbrt.com/Home/Records/lockBoxRoom?sig=d56ade1486d925717dc946181f6147c815494f21 HTTP/1.1
Host: api.uclbrt.com
Connection: Keep-Alive
Accept: application/json
Content-Length: 205
Content-Type: application/x-www-form-urlencoded
accountSid=98651082ab89c3f1b50f35caf794179f×tamp=1590379366&communityNo=1316879946&lockType=1&mac=343030022C0E&boxId=785
VII. Response Result
Success:
{"status":200,"info":"success"}
Failure:
{"status":4007,"info":"application is not certified"}
VIII. SDK