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

【通行记录】回调

POST
/openapi/webhook/passrecord
仅文档,甲方实现。
当访客通过设备时,我方服务器(域名 lot.booen.co,IP 163.179.62.248)会调用甲方提供的此接口,
将通行记录实时推送。甲方需将接口 URL 提供给我方,配置在后台 Webhook 设置界面。

请求参数

Body 参数application/json必填

示例
{
    "custom_id": "第三方唯一标识",
    "user_id": 0,
    "pass_at": 1657534225,
    "device_id": 65,
    "device_name": "xxx",
    "type": "10002",
    "name": "陈*惠",
    "card_id": "440************028",
    "record_type": 8,
    "image_base64": "/uploads/2022-07-11/e7ab303d-2381-4c78-922c-4ec9d03def75.jpg",
    "park_id": 8,
    "company_id": 69,
    "department_id": null,
    "remark": "",
    "host_user_id": 0,
    "host_id": null,
    "host_name": "",
    "pass_type": 1
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/openapi/webhook/passrecord' \
--header 'Content-Type: application/json' \
--data '{
    "custom_id": "第三方唯一标识",
    "user_id": 0,
    "pass_at": 1657534225,
    "device_id": 65,
    "device_name": "xxx",
    "type": "10002",
    "name": "陈*惠",
    "card_id": "440************028",
    "record_type": 8,
    "image_base64": "/uploads/2022-07-11/e7ab303d-2381-4c78-922c-4ec9d03def75.jpg",
    "park_id": 8,
    "company_id": 69,
    "department_id": null,
    "remark": "",
    "host_user_id": 0,
    "host_id": null,
    "host_name": "",
    "pass_type": 1
}'

返回响应

🟢200成功
application/json
甲方返回成功确认
Bodyapplication/json

示例
{
    "code": 0,
    "message": "success"
}
修改于 2026-07-09 15:37:45
上一页
获取 iframe 页面带权限链接
下一页
【设备】新建设备回调
Built with