# 在线核验
# 接口说明
| host | path | method | content-type |
|---|---|---|---|
| open.wecard.qq.com | /cgi-bin/guard/device/verify | POST | application/json |
# 请求参数
{
"access_token": "z8WH...R7Fd",
"device_no": "MRC00001",
"card_number": "12345678",
"physical_card_number": "7h5g0123",
"nonce": "abcdefg1234567"
}
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
access_token | ✔️ | string | 接口请求凭证 |
device_no | ✔️ | string | 门禁机具设备号 |
nonce | ✔️ | string | 随机噪声 |
card_number | string | 电子卡号 | |
physical_card_number | string | 实体卡号 |
WARNING
card_number、physical_card_number不能同时为空
# 响应参数
# 允许通行
{
"code": 0,
"message": "",
"data": {
"pass": true
}
}
# 禁止通行
{
"code": 0,
"message": "",
"data": {
"pass": false,
"reason": "电子卡号/学工号错误或用户不存在"
}
}
# 常见错误
{
"code": 20001,
"message": "机具不存在"
}
{
"code": 20004,
"message": "机具已注册到其他主体下"
}
{
"code": 20008,
"message": "请求重复"
}