录入访客来访申请信息

POST

/openapi/visitor/application

创建一条访客来访申请记录，系统会根据 begin_at/end_at 控制设备授权时间段。

常用字段说明：

third_id：第三方系统侧的来访申请唯一编号，用于幂等写入；同一单位、园区下重复传入会更新原申请。

qr_code：第三方系统生成的访客二维码内容。

host_*：被访人信息，例如 host_name、host_phone_number、host_company_id、department_name。

visitor_* / name / phone_number：来访人信息，例如 name、gender、phone_number、certificates_type、certificate_number。

reception_area_id：接待区域 ID，可通过 /openapi/reception/area/list 查询；传入后系统会按区域绑定设备执行后续同步。

begin_at / end_at：来访开始/结束时间，13 位毫秒时间戳。

avatar：来访人头像，可传图片 URL 或 data:image/...;base64,...。

请求参数

Query 参数

Body 参数application/json必填

示例

{
    "sn": "",
    "third_id": "1234",
    "qr_code": "123",
    "host_id": null,
    "host_user_id": null,
    "host_phone_number": "18029926959",
    "host_name": "某某",
    "park_id": 2,
    "park_name": "",
    "host_company_id": 3,
    "host_company_name": "测试单位",
    "department_id": null,
    "department_name": "技术部",
    "reception_area_id": 12,
    "reason": "测试",
    "begin_at": 1658138400000,
    "end_at": 1658140200000,
    "review_status": "2",
    "visit_status": "",
    "is_cancel": 0,
    "e_license": "",
    "name": "某某",
    "gender": "男",
    "avatar": "/uploads/2023-03-06/18c9eab6-4b87-4776-b38e-a3e3464d6c0b.png",
    "phone_number": "18924911xxx",
    "certificates_type": "身份证",
    "certificate_number": "44122519860714xxxx",
    "license_plate": "粤XXXXXXX",
    "company_name": "",
    "params_1": "",
    "params_2": "",
    "params_3": "",
    "is_enabled": 0,
    "user_id": null
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/visitor/application?access_token=undefined' \
--header 'Content-Type: application/json' \
--data '{
    "sn": "",
    "third_id": "1234",
    "qr_code": "123",
    "host_id": null,
    "host_user_id": null,
    "host_phone_number": "18029926959",
    "host_name": "某某",
    "park_id": 2,
    "park_name": "",
    "host_company_id": 3,
    "host_company_name": "测试单位",
    "department_id": null,
    "department_name": "技术部",
    "reception_area_id": 12,
    "reason": "测试",
    "begin_at": 1658138400000,
    "end_at": 1658140200000,
    "review_status": "2",
    "visit_status": "",
    "is_cancel": 0,
    "e_license": "",
    "name": "某某",
    "gender": "男",
    "avatar": "/uploads/2023-03-06/18c9eab6-4b87-4776-b38e-a3e3464d6c0b.png",
    "phone_number": "18924911xxx",
    "certificates_type": "身份证",
    "certificate_number": "44122519860714xxxx",
    "license_plate": "粤XXXXXXX",
    "company_name": "",
    "params_1": "",
    "params_2": "",
    "params_3": "",
    "is_enabled": 0,
    "user_id": null
}'

返回响应

🟢200成功

application/json

成功

Bodyapplication/json

示例

codemessagedatacount

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

获取 AccessToken

获取访客来访申请信息列表