# 进出记录上报
腾讯微卡提供了门禁进出记录上报的接口,通过上报接口,可以把通行门的用户记录上报到后台,支持发送通知,有抓拍图片字段时,图片会经过压缩下发。
# 接口说明
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"]
}
}