1. 访客申请管理
访客管理系统通用接口文档
  • OpenApi
    • 认证
      • 获取 AccessToken
    • 访客申请管理
      • 录入访客来访申请信息
        POST
      • 获取访客来访申请信息列表
        GET
      • 录入访客来访申请信息并同步到指定设备
        POST
      • 修改访客来访申请信息
        POST
      • 修改访客来访申请信息并同步到指定设备
        POST
      • 取消访客来访申请
        POST
      • 创建访客码
        POST
    • 通行记录
      • 获取访客通行记录(访客清单)
      • 获取白名单(内部人员)通行记录
      • 获取车辆通行记录
      • 查询异常的通行记录(健康信息查询)
    • 访客核验设备数据
      • 获取访客核验设备签到签离数据
      • 获取访客核验设备签到签离数据
    • 设备管理
      • 清空设备登记访客信息
      • 查询设备实际登记访客信息
      • 查询设备列表
    • 通行区域
      • 查询接待区域列表
      • 新增接待区域
      • 修改接待区域
      • 删除接待区域
      • 查询接待区域与设备绑定关系
    • 部门管理
      • 获取部门列表
      • 新增部门
      • 修改部门
      • 删除部门
    • 内部人员管理
      • 获取人员列表
      • 新增人员
      • 修改人员
      • 删除人员
      • 生成二维码
      • 新增人员并同步到指定设备
      • 修改人员并同步到指定设备
      • 从设备删除人员信息
      • 查询人员在设备的状态
      • 生成员工邀约码
      • 生成员工邀约小程序码
    • 黑名单人员管理
      • 获取黑名单列表
      • 新增黑名单
      • 修改黑名单
      • 删除黑名单
    • H5 快速登录
      • 签发 H5 快速登录码
      • H5 快速登录入口
    • 微信公众号
      • 获取微信 access_token
      • 获取微信 jsapi_ticket
    • 系统工具
      • 查询单位列表
      • 获取首页统计数据
      • 上传图片
      • 获取 iframe 页面带权限链接
    • Webhook
      • 【通行记录】回调
      • 【设备】新建设备回调
      • 【设备】修改设备回调
      • 【设备】删除设备回调
      • 【内部人员】扫码回调
    • 设备同步反馈及日志
      • 员工同步日志查询
      • 访客同步日志查询
      • 照片规范合格验证
      • 手动触发员工信息同步
      • 手动触发访客信息同步
  • 数据模型
    • BaseResponse
    • VisitorApplicationForm
    • EmployeeInviteRequest
    • SignRecordItem
    • EmployeeInviteData
    • H5LoginRequest
    • EmployeeInviteResponse
    • H5LoginResponseData
    • H5LoginEntryResponseData
  1. 访客申请管理

录入访客来访申请信息并同步到指定设备

POST
/openapi/visitor/application/with/devices
与"录入访客来访申请信息"相同,额外接受 device_ids 参数,将访客信息同步到指定设备列表。

请求参数

Query 参数

Body 参数application/json必填

示例
{
    "device_ids": [
        31
    ],
    "sn": "",
    "third_id": "1234",
    "qr_code": "123",
    "host_phone_number": "18029926959",
    "host_name": "某某",
    "park_id": 2,
    "host_company_id": 3,
    "host_company_name": "测试单位",
    "department_name": "技术部",
    "reception_area_id": 12,
    "reason": "测试",
    "begin_at": 1658138400000,
    "end_at": 1658140200000,
    "review_status": "2",
    "name": "某某",
    "gender": "男",
    "avatar": "/uploads/2023-03-06/18c9eab6-4b87-4776-b38e-a3e3464d6c0b.png",
    "phone_number": "18924911xxx",
    "certificates_type": "身份证",
    "certificate_number": "44122519860714xxxx",
    "license_plate": "粤XXXXXXX"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/openapi/visitor/application/with/devices?access_token=undefined' \
--header 'Content-Type: application/json' \
--data '{
    "device_ids": [
        31
    ],
    "sn": "",
    "third_id": "1234",
    "qr_code": "123",
    "host_phone_number": "18029926959",
    "host_name": "某某",
    "park_id": 2,
    "host_company_id": 3,
    "host_company_name": "测试单位",
    "department_name": "技术部",
    "reception_area_id": 12,
    "reason": "测试",
    "begin_at": 1658138400000,
    "end_at": 1658140200000,
    "review_status": "2",
    "name": "某某",
    "gender": "男",
    "avatar": "/uploads/2023-03-06/18c9eab6-4b87-4776-b38e-a3e3464d6c0b.png",
    "phone_number": "18924911xxx",
    "certificates_type": "身份证",
    "certificate_number": "44122519860714xxxx",
    "license_plate": "粤XXXXXXX"
}'

返回响应

🟢200成功
application/json
成功
Bodyapplication/json

示例
0
修改于 2026-07-09 15:37:45
上一页
获取访客来访申请信息列表
下一页
修改访客来访申请信息
Built with