# 访客管理系统通用接口文档 ## API Docs - OpenApi > 认证 [获取 AccessToken](https://osf3dnmm3r.apifox.cn/443354081e0.md): 调用所有开放接口前，需先获取 access_token。 - OpenApi > 访客申请管理 [录入访客来访申请信息](https://osf3dnmm3r.apifox.cn/443354082e0.md): 创建一条访客来访申请记录，系统会根据 begin_at/end_at 控制设备授权时间段。 - OpenApi > 访客申请管理 [获取访客来访申请信息列表](https://osf3dnmm3r.apifox.cn/443354083e0.md): 按更新时间区间查询访客来访申请列表，支持分页。 - OpenApi > 访客申请管理 [录入访客来访申请信息并同步到指定设备](https://osf3dnmm3r.apifox.cn/443354084e0.md): 与"录入访客来访申请信息"相同，额外接受 device_ids 参数，将访客信息同步到指定设备列表。 - OpenApi > 访客申请管理 [修改访客来访申请信息](https://osf3dnmm3r.apifox.cn/443354085e0.md): 根据申请单 id 更新部分字段，支持修改姓名、性别、手机号、单位、事由、照片等。 - OpenApi > 访客申请管理 [修改访客来访申请信息并同步到指定设备](https://osf3dnmm3r.apifox.cn/443354086e0.md): 与"修改访客来访申请信息"相同，额外接受 device_ids 参数，将更新同步到指定设备列表。 - OpenApi > 访客申请管理 [取消访客来访申请](https://osf3dnmm3r.apifox.cn/443354087e0.md): - OpenApi > 访客申请管理 [创建访客码](https://osf3dnmm3r.apifox.cn/443354088e0.md): 根据第三方自定义ID和访客码内容，为已有的访客申请单创建或关联一个访客码。 - OpenApi > 通行记录 [获取访客通行记录（访客清单）](https://osf3dnmm3r.apifox.cn/443354089e0.md): - OpenApi > 通行记录 [获取白名单（内部人员）通行记录](https://osf3dnmm3r.apifox.cn/444539318e0.md): - OpenApi > 通行记录 [获取车辆通行记录](https://osf3dnmm3r.apifox.cn/443354090e0.md): - OpenApi > 通行记录 [查询异常的通行记录（健康信息查询）](https://osf3dnmm3r.apifox.cn/443354091e0.md): - OpenApi > 访客核验设备数据 [获取访客核验设备签到签离数据](https://osf3dnmm3r.apifox.cn/443354099e0.md): 查询访客通过核验设备（桌面式访客一体机等）完成签到或签离的记录。 - OpenApi > 访客核验设备数据 [获取访客核验设备签到签离数据](https://osf3dnmm3r.apifox.cn/447492674e0.md): 查询访客通过访客核验设备（访客一体机等）完成签到或签离的记录。 - OpenApi > 设备管理 [清空设备登记访客信息](https://osf3dnmm3r.apifox.cn/443354092e0.md): 清空指定设备上已登记的访客白名单信息。 - OpenApi > 设备管理 [查询设备实际登记访客信息](https://osf3dnmm3r.apifox.cn/443354093e0.md): - OpenApi > 设备管理 [查询设备列表](https://osf3dnmm3r.apifox.cn/443354094e0.md): - OpenApi > 通行区域 [查询接待区域列表](https://osf3dnmm3r.apifox.cn/450369083e0.md): 查询当前 OpenAPI 账号权限范围内的接待区域列表。接待区域用于访客预约的来访区域选择，也用于限定访客数据下发到哪些绑定设备。 - OpenApi > 通行区域 [新增接待区域](https://osf3dnmm3r.apifox.cn/450458637e0.md): 新增一个接待区域。单位账号会自动归属到当前单位；园区账号必须传入 company_id，且该单位必须属于当前园区。 - OpenApi > 通行区域 [修改接待区域](https://osf3dnmm3r.apifox.cn/450458638e0.md): 修改接待区域名称、第三方唯一标识、默认区域状态，或同步更新区域绑定设备。 - OpenApi > 通行区域 [删除接待区域](https://osf3dnmm3r.apifox.cn/450458639e0.md): 删除指定接待区域，并同步删除该区域与设备的绑定关系。只能删除当前 OpenAPI 账号权限范围内的区域。 - OpenApi > 通行区域 [查询接待区域与设备绑定关系](https://osf3dnmm3r.apifox.cn/450369084e0.md): 查询接待区域绑定的设备列表。开发者可先读取区域，再根据区域下的设备查询通行记录。录入访客申请时传入 reception_area_id 后，系统会按该区域绑定设备进行后续同步。 - OpenApi > 部门管理 [获取部门列表](https://osf3dnmm3r.apifox.cn/443354100e0.md): - OpenApi > 部门管理 [新增部门](https://osf3dnmm3r.apifox.cn/443354101e0.md): - OpenApi > 部门管理 [修改部门](https://osf3dnmm3r.apifox.cn/443354102e0.md): - OpenApi > 部门管理 [删除部门](https://osf3dnmm3r.apifox.cn/443354103e0.md): - OpenApi > 内部人员管理 [获取人员列表](https://osf3dnmm3r.apifox.cn/443354104e0.md): - OpenApi > 内部人员管理 [新增人员](https://osf3dnmm3r.apifox.cn/443354105e0.md): - OpenApi > 内部人员管理 [修改人员](https://osf3dnmm3r.apifox.cn/443354106e0.md): - OpenApi > 内部人员管理 [删除人员](https://osf3dnmm3r.apifox.cn/443354107e0.md): - OpenApi > 内部人员管理 [生成二维码](https://osf3dnmm3r.apifox.cn/443354108e0.md): 根据人员信息生成二维码字符串，供设备扫码识别。 - OpenApi > 内部人员管理 [新增人员并同步到指定设备](https://osf3dnmm3r.apifox.cn/443354109e0.md): 与"新增人员"相同，额外接受 device_ids 参数，将人员信息同步到指定设备列表。 - OpenApi > 内部人员管理 [修改人员并同步到指定设备](https://osf3dnmm3r.apifox.cn/443354110e0.md): 与"修改人员"相同，额外接受 device_ids 参数，将更新同步到指定设备列表。 - OpenApi > 内部人员管理 [从设备删除人员信息](https://osf3dnmm3r.apifox.cn/443354111e0.md): 将指定人员从指定设备列表中删除（不删除系统中的人员记录）。 - OpenApi > 内部人员管理 [查询人员在设备的状态](https://osf3dnmm3r.apifox.cn/443354112e0.md): 查询指定人员是否已同步到指定设备列表。 - OpenApi > 内部人员管理 [生成员工邀约码](https://osf3dnmm3r.apifox.cn/496125314e0.md): 根据员工ID生成访客填写邀约信息所需的邀约码和访问路径。 - OpenApi > 内部人员管理 [生成员工邀约小程序码](https://osf3dnmm3r.apifox.cn/496125315e0.md): 根据员工ID生成可扫码进入访客邀约页面的微信小程序码。 - OpenApi > 黑名单人员管理 [获取黑名单列表](https://osf3dnmm3r.apifox.cn/443354113e0.md): - OpenApi > 黑名单人员管理 [新增黑名单](https://osf3dnmm3r.apifox.cn/443354114e0.md): - OpenApi > 黑名单人员管理 [修改黑名单](https://osf3dnmm3r.apifox.cn/443354115e0.md): - OpenApi > 黑名单人员管理 [删除黑名单](https://osf3dnmm3r.apifox.cn/443354116e0.md): - OpenApi > H5 快速登录 [签发 H5 快速登录码](https://osf3dnmm3r.apifox.cn/485016347e0.md): 第三方系统调用本接口，为指定员工或访客签发 60 秒有效的一次性 `login_code`。 - OpenApi > H5 快速登录 [H5 快速登录入口](https://osf3dnmm3r.apifox.cn/485016348e0.md): H5 浏览器访问本接口，系统原子消费一次性 `login_code` 并建立当前浏览器 Session。 - OpenApi > 微信公众号 [获取微信 access_token](https://osf3dnmm3r.apifox.cn/443394804e0.md): 通过访客系统服务端代理获取微信公众号 access_token，有效期 7200 秒。 - OpenApi > 微信公众号 [获取微信 jsapi_ticket](https://osf3dnmm3r.apifox.cn/443394805e0.md): 通过访客系统服务端代理获取微信公众号 jsapi_ticket，有效期 7200 秒。 - OpenApi > 系统工具 [查询单位列表](https://osf3dnmm3r.apifox.cn/443354095e0.md): - OpenApi > 系统工具 [获取首页统计数据](https://osf3dnmm3r.apifox.cn/443354096e0.md): - OpenApi > 系统工具 [上传图片](https://osf3dnmm3r.apifox.cn/443354097e0.md): - OpenApi > 系统工具 [获取 iframe 页面带权限链接](https://osf3dnmm3r.apifox.cn/443354098e0.md): 生成一个带有认证 code 的 iframe 跳转链接，供第三方系统嵌入访客系统管理页面。 - OpenApi > Webhook [【通行记录】回调](https://osf3dnmm3r.apifox.cn/443354117e0.md): **仅文档，甲方实现。** - OpenApi > Webhook [【设备】新建设备回调](https://osf3dnmm3r.apifox.cn/443354118e0.md): **仅文档，甲方实现。** - OpenApi > Webhook [【设备】修改设备回调](https://osf3dnmm3r.apifox.cn/443354119e0.md): **仅文档，甲方实现。** - OpenApi > Webhook [【设备】删除设备回调](https://osf3dnmm3r.apifox.cn/443354120e0.md): **仅文档，甲方实现。** - OpenApi > Webhook [【内部人员】扫码回调](https://osf3dnmm3r.apifox.cn/443354121e0.md): **仅文档，甲方实现。** - OpenApi > 设备同步反馈及日志 [员工同步日志查询](https://osf3dnmm3r.apifox.cn/443354122e0.md): 查询内部人员下发到设备的同步记录。 - OpenApi > 设备同步反馈及日志 [访客同步日志查询](https://osf3dnmm3r.apifox.cn/443354123e0.md): 查询访客申请单下发到设备的同步记录。 - OpenApi > 设备同步反馈及日志 [照片规范合格验证](https://osf3dnmm3r.apifox.cn/443354124e0.md): 对照片进行质量评分，可过滤掉大部分不合格照片。 - OpenApi > 设备同步反馈及日志 [手动触发员工信息同步](https://osf3dnmm3r.apifox.cn/443354125e0.md): 手动触发将指定员工信息同步到指定设备。 - OpenApi > 设备同步反馈及日志 [手动触发访客信息同步](https://osf3dnmm3r.apifox.cn/443354126e0.md): 手动触发将指定访客申请单同步到指定设备。 ## Schemas - [BaseResponse](https://osf3dnmm3r.apifox.cn/264209192d0.md): - [VisitorApplicationForm](https://osf3dnmm3r.apifox.cn/264209193d0.md): - [EmployeeInviteRequest](https://osf3dnmm3r.apifox.cn/300578741d0.md): - [SignRecordItem](https://osf3dnmm3r.apifox.cn/264209194d0.md): - [EmployeeInviteData](https://osf3dnmm3r.apifox.cn/300578742d0.md): - [H5LoginRequest](https://osf3dnmm3r.apifox.cn/293072787d0.md): - [EmployeeInviteResponse](https://osf3dnmm3r.apifox.cn/300578743d0.md): - [H5LoginResponseData](https://osf3dnmm3r.apifox.cn/293072788d0.md): - [H5LoginEntryResponseData](https://osf3dnmm3r.apifox.cn/293072789d0.md):