获取访客核验设备签到签离数据

GET

/openapi/sign/record

查询访客通过访客核验设备（访客一体机等）完成签到或签离的记录。

数据来源： 访客预约申请单 (visitor_application_form) 的签到时间 / 签离时间字段。
每张预约单按 sign_in_at / sign_out_at 非零情况展开成 0/1/2 条事件，并按 sign_time 倒序返回。

返回数据包含：访客基本信息、核验方式（人脸/访客码/身份证等）、
人脸照片、签到/签离时间、设备信息、当前签到状态快照。

verify_method / device_id / device_name 来自关联的最近一次通行记录（pass_record_visitor），若无匹配记录则为空。

注意： 姓名、手机号、身份证号支持明文查询，后端会自动匹配加密存储的数据。

请求参数

Query 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/sign/record?access_token=9657397458f94eafb765d0c2072e7900&from=1776096000&to=1776182400&direction=in&form_id=367&visitor_name=%E5%87%8C%E5%B7%A5&phone_number=13512345678&id_card_no=44122519860714xxxx&limit=undefined&offset=undefined'

返回响应

🟢200成功

application/json

成功

Bodyapplication/json

示例

{
    "code": 0,
    "message": "success",
    "count": 1,
    "data": [
        {
            "form_id": 367,
            "visitor_name": "凌工",
            "phone_number": "13512345678",
            "id_card_no": "44122519860714xxxx",
            "avatar": "/uploads/2026-04-14/883d981c-4a67-4772-9090-03a6ad3d916e-compare.jpg",
            "verify_method": "人脸识别",
            "direction": "in",
            "sign_time": 1776937409,
            "device_id": 30,
            "device_name": "访客一体机",
            "status": "已签到"
        }
    ]
}

修改于 2026-07-09 15:37:45