访客同步日志查询

POST

/openapi/sync/log/visitor

查询访客申请单下发到设备的同步记录。

时间字段说明：

请求参数 from_time / to_time 按 visitor_device_sync_record.start_time 过滤，使用 13 位 Unix 毫秒级时间戳。

返回字段 sync_time 为访客同步开始时间，使用 13 位 Unix 毫秒级时间戳。

show_all 默认为 false，只返回每台设备、每张访客申请单的最新一条同步记录；传 true 可返回符合条件的全部同步记录。

请求参数

Query 参数

Body 参数application/json必填

示例

{
    "visitor_form_id": 194588,
    "visitor_name": "徐治强",
    "host_name": "徐治强",
    "host_job_number": "123",
    "device_id": 30,
    "from_time": 1768195200000,
    "to_time": 1768281600000,
    "show_all": false,
    "offset": 0,
    "limit": 20
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/sync/log/visitor?access_token=undefined' \
--header 'Content-Type: application/json' \
--data '{
    "visitor_form_id": 194588,
    "visitor_name": "徐治强",
    "host_name": "徐治强",
    "host_job_number": "123",
    "device_id": 30,
    "from_time": 1768195200000,
    "to_time": 1768281600000,
    "show_all": false,
    "offset": 0,
    "limit": 20
}'

返回响应

🟢200成功

application/json

成功

Bodyapplication/json

示例

{
    "code": 0,
    "message": "success",
    "count": 1,
    "data": [
        {
            "id": 696732,
            "device_id": 30,
            "device_name": "人脸门禁一体机",
            "visitor_form_id": 194588,
            "visitor_name": "徐治强",
            "host_id": 17980,
            "host_user_id": 59430,
            "host_name": "徐治强",
            "host_job_number": "",
            "sync_status": 2,
            "sync_time": 1768280075704,
            "error_message": "同步超时 (应用请求但设备未在规定时间内响应)",
            "operation_type": "add"
        }
    ]
}

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

员工同步日志查询

照片规范合格验证