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

查询接待区域与设备绑定关系

GET
/openapi/reception/area/device/list
查询接待区域绑定的设备列表。开发者可先读取区域,再根据区域下的设备查询通行记录。录入访客申请时传入 reception_area_id 后,系统会按该区域绑定设备进行后续同步。
注意:不传 reception_area_id 时,本接口返回当前账号权限范围内的全部“区域-设备绑定关系”,不是设备总列表;未绑定任何接待区域的设备不会出现在本接口中。如需查询设备总列表,请使用 /openapi/device/list。
分页说明:
count 为符合当前查询条件的总记录数,不是本次 data 返回的条数。
limit 为本次最多返回条数。
offset 为跳过的记录条数,不是页码。例如 limit=50&offset=0 返回第 0-49 条,limit=50&offset=50 返回第 50-99 条;如果传 limit=50&offset=1,则表示跳过 1 条后返回第 1-50 条。

请求参数

Query 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/openapi/reception/area/device/list?access_token=undefined&reception_area_id=undefined&company_id=undefined&park_id=undefined&limit=undefined&offset=undefined'

返回响应

🟢200成功
application/json
成功。响应中的 count 为符合查询条件的总记录数;data 为当前 limit/offset 返回的数据列表。
Bodyapplication/json

示例
{
    "code": 0,
    "message": "success",
    "count": 1,
    "data": [
        {
            "reception_area_id": 12,
            "reception_area_name": "办公区",
            "park_id": 1,
            "park_name": "测试园区",
            "company_id": 1,
            "company_name": "测试单位",
            "device_id": 30,
            "device_name": "人脸门禁一体机",
            "device_type": "10004",
            "device_model": "海清门禁设备",
            "direction": "入口",
            "serial_no": "DC2D454E6A35",
            "uuid": "",
            "ip": "192.168.1.10",
            "is_enabled": true,
            "is_online": true,
            "is_active": true
        }
    ]
}
修改于 2026-07-09 15:37:45
上一页
删除接待区域
下一页
获取部门列表
Built with