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

    H5LoginRequest

    H5 快速登录码签发请求。park_id 与 company_id 至少传一个;
    user_id、oa_id、phone_number + name 至少传入一种身份。
    身份解析优先级为 user_id -> oa_id -> phone_number + name。
    如果同时传入多种身份,系统会校验它们是否指向同一用户。
    user_id 会优先按员工成员 ID(user_attributes.id)匹配员工;未命中员工时兼容按用户账号 ID(user.id)匹配。
    oa_id 会优先按 GRPC 同步员工的外部唯一标识匹配员工;员工没有绑定用户账号时会自动创建员工账号。
    未命中员工时,再按当前 OpenAPI app_id 下的 H5 绑定关系匹配;首次创建访客绑定时需要同时传入 phone_number 和 name。
    phone_number + name 会优先匹配员工档案,未命中员工时再匹配或创建访客账号。

    {
        "park_id": 1,
        "company_id": 1,
        "user_id": 123,
        "oa_id": "OA-USER-001",
        "phone_number": "13800138000",
        "name": "张三",
        "redirect": "/h5v2/pages/index/index?park_id=1&company_id=1"
    }
    Built with