| | |
|---|
| | | 返回值统一格式：
|
|---|
| | | {
|
|---|
| | | msg : {},
|
|---|
| | | info : "",
|
|---|
| | | code : int
|
|---|
| | | }
|
|---|
| | |
|
|---|
| | |
|
|---|
| | | #todo 人脸识别错误（注册、访客变更员工）时保护业务数据的问题
|
|---|
| | | # Request考虑socket直接和人脸识别服务器交互
|
|---|
| | | # API安全
|
|---|
| | |
|
|---|
| | | 0.1交换authorizationID
|
|---|
| | | Request:
|
|---|
| | | {
|
|---|
| | | authorizationID: "aaaaa"
|
|---|
| | | }
|
|---|
| | | Response:
|
|---|
| | | {
|
|---|
| | | registerCompanyID : 1,
|
|---|
| | | placeID : 1
|
|---|
| | | companyName : "aaa",
|
|---|
| | | placeLabel: "aaaaa"
|
|---|
| | | }
|
|---|
| | |
|
|---|
| | | 0.2注册设备地点
|
|---|
| | | Request:
|
|---|
| | | {
|
|---|
| | | placeLabel: "aaaaa"
|
|---|
| | | }
|
|---|
| | | Response:
|
|---|
| | | {
|
|---|
| | | placeID : 1
|
|---|
| | | }
|
|---|
| | |
|
|---|
| | | 1. 实时监控
|
|---|
| | | 1.1. 人员分类分类列表(VisitorType)
|
|---|
| | |
|---|
| | |
|
|---|
| | | 1.2. StatusID
|
|---|
| | |
|
|---|
| | | 1.3. 人脸识别 #todo 考虑封装一个整体api
|
|---|
| | | 1.3. 人脸识别
|
|---|
| | | 通过图像获得faceID
|
|---|
| | | Request:
|
|---|
| | | {
|
|---|
| | |
|---|
| | | {
|
|---|
| | | registerCompanyID : 123, //找不到返回VisitDBFaceID，此项为-1
|
|---|
| | | faceID : 1,
|
|---|
| | | isVisitDBFaceID : false,
|
|---|
| | | isVisitDBFaceID : false, // <dbid=-1, faceid!=-1> : true, <dbid!=-1, faceid!=-1> : false
|
|---|
| | | srcImgIdx : 1,
|
|---|
| | | srcImgPosX : 123,
|
|---|
| | | srcImgPosY : 456
|
|---|
| | | srcImgPosY : 456,
|
|---|
| | | srcImgPosW : 123,
|
|---|
| | | srcImgPosH : 456
|
|---|
| | | },
|
|---|
| | | {
|
|---|
| | | faceID : -1, // 搜索无结果
|
|---|
| | | faceID : -1, // 搜索无结果 <dbid=-1, faceid=-1>
|
|---|
| | | }
|
|---|
| | | ]
|
|---|
| | |
|
|---|
| | |
|---|
| | | {
|
|---|
| | | personID : 123, // 无效值表示没有对应的人ID
|
|---|
| | | personTypeID : 1, // 人员分类列表
|
|---|
| | | visitStatusID : 1, // 访问状态 #新建表保存数据
|
|---|
| | | visitStatusID : 1, // 访问状态
|
|---|
| | | name : "name",
|
|---|
| | | checkingCompany : [123, 456], // 考勤公司ID列表
|
|---|
| | | warning : false // 是否为警告
|
|---|
| | |
|---|
| | | {
|
|---|
| | | placeID : 123,
|
|---|
| | | personID : 123,
|
|---|
| | | visitStatusID : 1 // 访问状态
|
|---|
| | | visitStatusID : 1 // 设置访问状态
|
|---|
| | | }
|
|---|
| | | Response:
|
|---|
| | | 成功/错误结果
|
|---|
| | |
|
|---|
| | | 1.6.1. 人脸识别及状态修改
|
|---|
| | | 整合：通过人脸图像，完成状态修改，返回当前状态
|
|---|
| | | （整合1.3. 1.4. 1.6.）
|
|---|
| | | Request:
|
|---|
| | | {
|
|---|
| | | placeID : 123, // 若为-1则只搜索VisitFaceDB
|
|---|
| | | visitStatusID : 1 // 签到、签退/签离
|
|---|
| | | imgs : [ "image base64" ] // 对应多个人的人脸图像
|
|---|
| | | }
|
|---|
| | | Response:
|
|---|
| | | [
|
|---|
| | | {
|
|---|
| | | personID : 123,
|
|---|
| | | visitStatusID : 1 // 更新之后的访问状态
|
|---|
| | | },
|
|---|
| | | {
|
|---|
| | | faceID : -1, // 人脸搜索无结果
|
|---|
| | | },
|
|---|
| | | {
|
|---|
| | | //业务错误： 9.1. 通用成功/错误结果
|
|---|
| | | }
|
|---|
| | | ]
|
|---|
| | |
|
|---|
| | | 1.7. 查询人员来访/签到状态
|
|---|
| | | 需要支持批量查询
|
|---|
| | | Request:
|
|---|
