# 进出记录上报

腾讯微卡提供了门禁进出记录上报的接口,通过上报接口,可以把通行门的用户记录上报到后台,支持发送通知,有抓拍图片字段时,图片会经过压缩下发。

# 接口说明

host path method content-type
open.wecard.qq.com /cgi-bin/device/guard/gate-report POST application/json

# 请求参数

{
  "access_token": "z8WH...R7Fd",
  "send_notice": 1,
  "records": [
    {
      "report_mark": "9cdc84d7cbc300a700",
      "card_number": "202010001",
      "gate_id": 10,
      "mode": 4,
      "temperature": 37.2,
      "images": ["9j/4AAQSkZ...ztQud1PK3//Z", "9j/4AAQSkZ...Lqp2udPKj//Z"],
      "snap_image": "9j/4AAQSkZ...Lqp2udPKj//Z",
      "pass": 1,
      "pass_at": 1596164969,
      "reason": "",
      "remark": "测试"
    },
    {
      "report_mark": "9cdc84d7cbc300a701",
      "card_number": "202010002",
      "gate_id": 10,
      "mode": 4,
      "temperature": 36.5,
      "images": ["9j/4AAQSkZ...yzTud1PD5//Z", "9j/4AAQSkZ...ZoU2udPK2//Z"],
      "snap_image": "9j/4AAQSkZ...Zqp3udPKj//A",
      "pass": 0,
      "pass_at": 1596164969,
      "reason": "不在可通行名单中",
      "remark": ""
    }
  ]
}
参数 必填 类型 说明
access_token ✔️ string 接口请求凭证
send_notice int32 是否发送登记通知: 1: 发送; 0:不发送
report_mark ✔️ string 上报标记
card_number ✔️ string 电子卡号
gate_id ✔️ int64 门 ID
mode ✔️ int64 登记方式,0-其他,1-刷码,2-刷脸,3-刷卡,4-扫码,5-刷指纹,6-刷掌
temperature float64 体温,作为通行记录补充信息
images string[] 通行照片,作为通行记录补充信息; 需将图片 base64 编码
snap_image string[] 通行抓拍照片,作为通行记录补充信息; 需将图片 base64 编码
pass ✔️ int32 通行状态状态,0-未通过,1-允许通行
pass_at ✔️ int64 通行时间,unix 时间戳
reason int64 允许/不允许通行的原因
remark string 备注信息

# 响应参数

{
  "errcode": 0,
  "errmsg": "success",
  "data": {
    "fail_list": ["9cdc84d7cbc300a701"]
  }
}