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

签发 H5 快速登录码

POST
/openapi/h5/login
第三方系统调用本接口,为指定员工或访客签发 60 秒有效的一次性 login_code。
H5 浏览器随后访问 /openapi/h5/login/entry 即可建立访客系统 H5 登录态。
身份输入方式:
user_id:员工成员 ID(user_attributes.id)优先;未命中员工时兼容用户账号 ID(user.id)。
oa_id:第三方员工/用户 ID。优先按 GRPC 同步员工的 oa_key 匹配员工;员工没有绑定用户账号时会自动创建员工账号。未命中员工时,再按当前 OpenAPI 应用下的 H5 绑定关系匹配;首次创建访客绑定时必须同时传入 phone_number 和 name。
phone_number + name:手机号和姓名兜底匹配。系统会优先匹配员工档案,员工没有绑定用户账号时会自动创建员工账号;未命中员工时再匹配或创建访客账号。
oa_id 绑定按当前 OpenAPI 应用隔离,存储为 identity_type=openapi:h5、identifier=app_id、credential=oa_id。
redirect 只允许站内相对路径,例如 /h5v2/pages/index/index?company_id=1。

请求参数

Query 参数

Body 参数application/json必填

示例
{
    "company_id": 1,
    "oa_id": "EMP-OA-001",
    "redirect": "/h5v2/pages/index/index?company_id=1"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location '/openapi/h5/login?access_token=9657397458f94eafb765d0c2072e7900' \
--header 'Content-Type: application/json' \
--data '{
    "company_id": 1,
    "oa_id": "EMP-OA-001",
    "redirect": "/h5v2/pages/index/index?company_id=1"
}'

返回响应

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

示例
{
    "code": 0,
    "message": "success",
    "data": {
        "login_code": "0bfa4f0c-7a1d-4c62-b7ef-03f52c3bb8cf",
        "login_url": "https://fkytest.booen.co/openapi/h5/login/entry?login_code=0bfa4f0c-7a1d-4c62-b7ef-03f52c3bb8cf&redirect=%2Fh5v2%2Fpages%2Findex%2Findex%3Fpark_id%3D1%26company_id%3D1",
        "user_id": 123,
        "member_id": 9,
        "name": "张三",
        "expires_in": 60
    },
    "count": 0
}
修改于 2026-07-09 15:37:45
上一页
删除黑名单
下一页
H5 快速登录入口
Built with