# 在线核验

# 接口说明

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": "请求重复"
}