1.Overview
Developers send required parameters to server to report the loss of the picture QR code card
After the report is successful, you need to use the same cardNo to request the Obtain cards interface again to obtain a new room card and swipe it on the lock to complete the loss report.
Currently, only QRA-C4 or above supports single loss reporting. For other locks, please set up the wholeRoom parameter or create a loss reporting card using the Generate cards interface.
2.Examples
3. Request URL
4. Request parameter format
/?c=Qrcode&a=reportLost&sig={sig}
HTTP request header:
Accept:application/json;
Content-Type:application/x-www-form-urlencode;charset=uft-8;
Authorization:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
{"cardNo":"2EwNXzAmR9Voq67x"}
5. Parameter specification
Attribute |
Type |
Constraint |
Explanation |
accountSid |
String |
Required |
Developer Account SID, the unique identifier of developer(32 characters of letters and numbers). |
sig |
String |
Required |
Signature, API request required. |
Accept |
String |
Required |
Standard HTTP header, content-type: application/json |
Content-Type |
String |
Required |
Standard HTTP header, type:application/x-www-form-urlencode;charset=utf-8 |
Authorization |
String |
Required |
HTTP header authentication information |
cardNo |
String |
Required |
Unique room card No. |
cardType |
String |
Optional |
Card type, 0: room card (default), currently only support room card |
wholeRoom |
String |
Optional |
Whether to report the lost key of the whole room, 0: No (default) 1: Yes |
6. HTTP JSON request demo
HTTP header
Accept:application/json;
Content-Type:application/x-www-form-urlencode;charset=uft-8;
Authorization:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
{"cardNo":"2EwNXzAmR9Voq67x"}
Http Requested parameters
/?c=Qrcode&a=reportLost&sig=031A94222BB0AF73AA0DCDEB92D54609
Successful result
{"status":200,"info":success"}
Failure reason returning:
{ "status": 403, "info": "some 错误" }
7. XML request demo
HTTP header
Accept:application/xml;
Content-Type:application/x-www-form-urlencode;charset=uft-8;
Authorization:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
<?xml version='1.0' encoding='utf-8'?>
<Request>
<cardNo>2EwNXzAmR9Voq67x</cardNo>
<cardType>0</cardType>
</Request>
Http Requested parameters
/?c=Qrcode&a=reportLost&sig=031A94222BB0AF73AA0DCDEB92D54609
Successful result
<?xml version="1.0" encoding="UTF-8" ?>
<Response>
<status>200</status>
<info>success</info>
</Response>
Failure reason returning:
<?xml version="1.0" encoding="UTF-8" ?>
<Response>
<status>4003</status>
<info> some 错误 </info>
</Response>