1. 人员管理

1.1. 根据uuid返回人员信息

基础信息

路径: /v1/api/person/query

请求方法: POST

请求参数

Headers:

Body:

Body示例:

{
  "uuid": "343fe642be34486cb4957bb2b427448a"
}

返回数据

Headers:

Body:

响应示例:

{
  "code": 0,
  "data": {
    "groupList": [
      {
        "name": "默认访客组",
        "uuid": "23121432421342143124312421412444"
      }
    ],
    "name": "FK007",
    "orgName": "默认部门",
    "orgUuid": "0",
    "phone": "4DF1A573459E717021866ECC345F4BF2",
    "sex": 1,
    "tagList": [],
    "type": 2,
    "uuid": "4ce0f409692f4f2ba73adb3d04dd568b",
    "visitEndTime": 1679068800000,
    "visitFirm": "",
    "visitReason": "其他",
    "visitStartTime": 1678929828000,
    "visitStatus": 20,
    "visitType": 1,
    "visitedName": "Person01",
    "visitedStatus": true,
    "visitedUuid": "dde8cecd28534af29764ccd0722c833e"
  },
  "msg": "成功"
}

1.2. 批量添加人员

基础信息

路径: /v1/api/person/batchAdd

请求方法: POST

请求参数

Headers:

Body:

Body示例:

{
  "personList": [
    {
      "name": "Person009",
      "type": 1,
      "autograph": "这是个性签名",
      "sex": 0,
      "imageUri": "Z3NwOi8vd3Vrb25n-ea4c5059630dc52e1e2467ff3274eccf.jpg",
      "profilePhotoUri": "Z3NwOi8vd3Vrb25n-ea4c5059630dc52e1e2467ff3274eccf.jpg",
      "code": "Person009",
      "identifyNum": "7802b9f8d2ce09322ffd47e7f53164f5cca31d7baa04e2175c20619fde5b5a06",
      "uniqueIdentify": "2131234",
      "visitFirm": "",
      "visitStartTimeStamp": 1678946297332,
      "visitEndTimeStamp": 1679810297000,
      "visitReason": "面试",
      "visitedUuid": "dde8cecd28534af29764ccd0722c833e",
      "visitType": 1,
      "email": "",
      "phone": "8d9542b37c34485cedd56e2af3781d2e",

      "password": "",
      "postion": "老大",
      "birthdayStamp": 1678946297332,
      "ext": "",
      "groupList": [

      ],
      "orgUuid": "0",
      "visitStatus": 20
    }
  ]
}

返回数据

Headers:

Body:

响应示例:

{
  "code": 0,
  "data": {
    "failures": [],
    "successes": [
      {
        "autograph": "这是个性签名",
        "birthdayStamp": 1678946297332,
        "email": "",
        "ext": "",
        "groupList": [],
        "identifyNum": "7802B9F8D2CE09322FFD47E7F53164F5CCA31D7BAA04E2175C20619FDE5B5A06",
        "imageUri": "Z3NwOi8vd3Vrb25n-ea4c5059630dc52e1e2467ff3274eccf.jpg",
        "name": "Person009",
        "orgUuid": "0",
        "password": "",
        "phone": "8D9542B37C34485CEDD56E2AF3781D2E",
        "postion": "老大",
        "sex": 0,
        "staffCode": "Person009",
        "type": 1,
        "uuid": "8db4596fa1eb4721b7e347666c879378",
        "visitEndTimeStamp": 1679810297000,
        "visitReason": "面试",
        "visitStartTimeStamp": 1678946297332,
        "visitType": 1,
        "visitedUuid": "dde8cecd28534af29764ccd0722c833e"
      }
    ]
  },
  "msg": "成功"
}

1.3. 批量删除人员

基础信息

路径: /v1/api/person/batchDelete

请求方法: POST

请求参数

Headers:

Body:

Body示例:

{
  "uuidList":[
    "8db4596fa1eb4721b7e347666c879378"
  ]
}

返回数据

Headers:

Body:

响应示例:

{
  "code": 0,
  "data": {
    "failures": [],
    "successes": [
      {
        "uuid": "8db4596fa1eb4721b7e347666c879378"
      }
    ]
  },
  "msg": "成功"
}

1.4. 修改人员

基础信息

路径: /v1/api/person/update

请求方法: POST

请求参数

Headers:

Body:

Body示例:

{
  "uuid": "3538c00670db4508a522eb3494090577",
  "name": "NewName",
  "sex": 0,
  "imageUri": "Z3NwOi8vd3Vrb25n-ea4c5059630dc52e1e2467ff3274eccf.jpg",
  "code": "Person009",
  "identifyNum": "7802b9f8d2ce09322ffd47e7f53164f5cca31d7baa04e2175c20619fde5b5a06",
  "visitFirm": "",
  "visitStartTimeStamp": 1678946297332,
  "visitEndTimeStamp": 1679810297000,
  "visitReason": "",
  "visitedUuid": "",
  "email": "",
  "password": "",
  "postion": "",
  "birthdayStamp": 0,
  "ext": "",
  "groupList": [
    "4b238e3581cc4361847bda6a98c5f26e"
  ],
  "tagList": [
    "94523eed1ca347bd94dc712678c7fa4f"
  ],
  "orgUuid": "0"
}

返回数据

Headers:

Body:

响应示例:

{
  "code": 0,
  "msg": "成功"
}

1.5. 上传人员图片

基础信息

路径: /v1/api/person/uploadImage

请求方法: POST

请求参数

Headers:

表单:

返回数据

Headers:

Body:

响应示例:

{
  "code": 0,
  "data": {
    "uri": "Z3NwOi8vd3Vrb25n-cf68b8ab5240976b6ab9f201f85522fb.jpg"
  },
  "msg": "成功"
}

1.6. 上传人员图片（人脸质量判断按照最低标准进行判断）

基础信息

路径: /v1/api/person/config/uploadImage

请求方法: POST

请求参数

Headers:

表单:

返回数据

Headers:

Body:

响应示例:

{
  "code": 0,
  "data": {
    "uri": "Z3NwOi8vd3Vrb25n-490a83ae19d1dfcc9e2306eb45709db3.jpg"
  },
  "msg": "成功"
}

1.7. 根据uuid列表返回人员详细信息列表

基础信息

路径: /v1/api/person/uuid/list

请求方法: POST

请求参数

Headers:

Body:

Body示例:

{
  "uuidList":["3538c00670db4508a522eb3494090577"]
}

返回数据

Headers:

Body:

响应示例:

{
  "code": 0,
  "data": [
    {
      "code": "Person009",
      "ext": "",
      "groupList": [],
      "identifyNum": "7802B9F8D2CE09322FFD47E7F53164F5CCA31D7BAA04E2175C20619FDE5B5A06",
      "imageUri": "http://169.42.42.42:8089/v1/storage/download/Z3NwOi8vd3Vrb25n-ea4c5059630dc52e1e2467ff3274eccf.jpg",
      "name": "NewName",
      "orgName": "默认部门",
      "orgUuid": "0",
      "password": "",
      "phone": "8D9542B37C34485CEDD56E2AF3781D2E",
      "postion": "",
      "profilePhotoUri": "http://169.42.42.42:8089/v1/storage/download/Z3NwOi8vd3Vrb25n-ea4c5059630dc52e1e2467ff3274eccf.jpg",
      "sex": 0,
      "tagList": [],
      "type": 1,
      "uniqueIdentify": "2131234",
      "uuid": "3538c00670db4508a522eb3494090577",
      "visitFirm": "",
      "visitReason": "",
      "visitStatus": 20,
      "visitType": 1
    }
  ],
  "msg": "成功"
}

1.8. 搜索人员列表

基础信息

路径: /v1/api/person/list

请求方法: POST

请求参数

Headers:

Body:

Body示例:

{
  "name":"NewName"
}

返回数据

Headers:

Body:

响应示例:

{
  "code": 0,
  "data": {
    "list": [
      {
        "code": "Person009",
        "ext": "",
        "groupList": [],
        "identifyNum": "7802B9F8D2CE09322FFD47E7F53164F5CCA31D7BAA04E2175C20619FDE5B5A06",
        "imageUri": "http://169.42.42.42:8089/v1/storage/download/Z3NwOi8vd3Vrb25n-ea4c5059630dc52e1e2467ff3274eccf.jpg",
        "isAttendanceRecord": false,
        "isPassRecord": false,
        "name": "NewName",
        "orgName": "默认部门",
        "orgUuid": "0",
        "password": "",
        "phone": "8D9542B37C34485CEDD56E2AF3781D2E",
        "postion": "",
        "profilePhotoUri": "http://169.42.42.42:8089/v1/storage/download/Z3NwOi8vd3Vrb25n-ea4c5059630dc52e1e2467ff3274eccf.jpg",
        "sex": 0,
        "tagList": [
          {
            "tagName": "学生",
            "tagUuid": "94523eed1ca347bd94dc712678c7fa4f"
          }
        ],
        "type": 1,
        "uniqueIdentify": "2131234",
        "uuid": "3538c00670db4508a522eb3494090577",
        "visitFirm": "",
        "visitReason": "",
        "visitStatus": 20,
        "visitType": 1
      }
    ],
    "pageNum": 1,
    "pageSize": 20,
    "total": 1
  },
  "msg": "成功"
}

1.9. 访客预约列表

基础信息

路径: /v1/api/person/visitor/pageLike

请求方法: POST

请求参数

Headers:

Body:

Body示例:

{"name": "", "pageNum": 1, "pageSize": 5}

返回数据

Headers:

Body:

响应示例:

{
  "code": 0,
  "data": {
    "list": [
      {
        "gmtModified": 1678930704000,
        "groupList": [
          {
            "name": "默认访客组默认访客组默认访客组默认访客组默认访客组默认访客组默认访客组默认访客组",
            "uuid": "23121432421342143124312421412444"
          }
        ],
        "isPassRecord": false,
        "name": "FK008",
        "phone": "85B5B9DB67DBC3D3F67EB10C17810CD4",
        "sex": 1,
        "uuid": "06381ea6f89a4792b4fbd19e4f600123",
        "visitEndTime": 1679068800000,
        "visitFirm": "",
        "visitReason": "其他",
        "visitStartTime": 1678930693000,
        "visitStatus": 20,
        "visitType": 1,
        "visitedName": "Person01",
        "visitedUuid": "dde8cecd28534af29764ccd0722c833e"
      },
      {
        "gmtModified": 1678929838000,
        "groupList": [
          {
            "name": "默认访客组默认访客组默认访客组默认访客组默认访客组默认访客组默认访客组默认访客组",
            "uuid": "23121432421342143124312421412444"
          }
        ],
        "isPassRecord": false,
        "name": "FK007",
        "phone": "1E3091CBEB8955C64EA921DADA9166B8",
        "sex": 1,
        "uuid": "4ce0f409692f4f2ba73adb3d04dd568b",
        "visitEndTime": 1679068800000,
        "visitFirm": "",
        "visitReason": "其他",
        "visitStartTime": 1678929828000,
        "visitStatus": 20,
        "visitType": 1,
        "visitedName": "Person01",
        "visitedUuid": "dde8cecd28534af29764ccd0722c833e"
      }
    ],
    "pageNum": 1,
    "pageSize": 5,
    "total": 2
  },
  "msg": "成功"
}

1.10. 根据员工、访客UUID获取二维码

基础信息

路径: /v1/api/person/visitorCode

请求方法: POST

请求参数

Headers:

Body:

Body示例:

{
  "uuid": "3538c00670db4508a522eb3494090577"
}

返回数据

Headers:

Body:

响应示例:

{
  "code": 0,
  "data": {
    "expireTime": 10,
    "qrCode": "data:image/png;base64,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"
  },
  "msg": "成功"
}

1.11. 删除访客预约

基础信息

路径: /v1/api/person/sub/delete

请求方法: POST

请求参数

Headers:

Body:

Body示例:

{
  "uuidList": [
    "4ce0f409692f4f2ba73adb3d04dd568b"
  ]
}

返回数据

Headers:

Body:

响应示例:

{
  "code": 0,
  "msg": "",
  "data": {
    "successes": [
      "4ce0f409692f4f2ba73adb3d04dd568b"
    ],
    "failures": []
  }
}

1.12. 修改访客预约状态

基础信息

路径: /v1/api/person/status

请求方法: POST

请求参数

Headers:

Body:

Body示例:

{
  "uuidList": [
    "4ce0f409692f4f2ba73adb3d04dd568b"
  ],
  "visitStatus": 30
}

返回数据

Headers:

Body:

响应示例:

{
  "code": 0,
  "data": {
    "failures": [],
    "successes": [
      "4ce0f409692f4f2ba73adb3d04dd568b"
    ]
  },
  "msg": "成功"
}

1.13. 访客预约审批

基础信息

路径: /v1/api/person/visitor/edit

请求方法: POST

请求参数

Headers:

Body:

Body示例:

{
  "uuid": "aa9c22f13f01416ebcd2d3f950796d57",
  "visitStartTimeStamp": 1678948744361,
  "visitEndTimeStamp": 1679810297000,
  "visitReason": "",
  "groupList": [
    {
      "groupUuid": "23121432421342143124312421412444"
    }
  ],
  "visitType": 1,
  "visitStatus": 20
}

返回数据

Headers:

Body:

响应示例:

{
  "code": 0,
  "msg": "成功"
}