宜昌市建筑施工现场从业人员实名制人脸识别设备标准接口文档说明V3.0

目  录

一、 概述

二、 施工现场人脸识别设备数据对接流程

三、 接口调用方式

四、 API接口说明

1、 从平台获取人员信息

2、 从平台获取人员照片及人脸特征信息

3、 人员考勤信息上传

4、 人员体温信息上传

五、 技术支持

一、概述

宜昌“智慧城建”从业人员实名制管理平台(以下简称“宜昌实名制平台”)是宜昌市智慧城建系统的重要组成部分,宜昌实名制平台实现了全市建设行业从业人员实名登记、个人信息管理、项目人员派工、到岗考勤记录、培训考试记录、工资发放、项目从业记录、个人诚信等实名制相关的信息化管理功能,同时与公安、人社、省住建厅实名制等信息平台实现了数据互联互通。工地现场门禁系统必须统一接收宜昌市实名制管理平台的人员准入信息及人脸特征完成人员进出的考勤工作。

宜昌实名制平台提供免费开放式的API接口,主要用于工地现场已安装人脸识别设备,且设备参数符合要求的施工项目,通过该接口文档从平台获取项目派工人员基础信息、人脸特征、以及各施工项目上传进出场考勤信息及人员温度信息到平台的数据对接及数据交互。

二、施工现场人脸识别设备数据对接流程

步骤一:已安装设备的工地,在数据对接前,先联系宜昌实名制平台技术支持单位,获取该工程项目唯一编码及数据交互认证所需的用户名及密码。

步骤二:由施工现场设备提供方利用所获取的项目唯一编码及数据交互认证所需的用户名及密码,按接口文档所列数据交互内容与宜昌实名制平台测试库进行数据对接联调测试。

步骤三:测试内容包含从平台端获取该项目已派工人员的基础信息及人脸特征,将获取的数据写入现场人脸识别设备进行人脸特征验证比对,同时将已派工人员在现场认证通过的考勤记录、温度记录回传至平台,并将进出人员的姓名、工种、岗位、考勤时间、温度等信息在门禁通道处的屏幕予以公开显示。

步骤四:以上全部内容在测试库完成测试,经平台技术支持服务单位确认无误后,与宜昌实名制平台正式库进行数据交互,完成现场人脸识别设备数据对接流程。

三、接口调用方式

POST:创建对象、提交请求包含验证及数据包信息。

GET: 查询对象、提交请求包含验证及数据包信息。

请求举例:

http://ulr/labor/externalCall/person?sgxkId=***&code=***

响应举例:

{

    "msg": "请检查人员id、身份证、体温、记录日期等信息是否完整",

    "code": 0,

    "data": false

}

四、API接口说明

1、从平台获取人员信息

功能描述:从宜昌实名制平台获取已派工进场从业人员基础信息(不包含身份证头像和人脸特征照片)§  请求报文头(HTTP)    GET    http://111.47.65.236:2228/labor/externalCall/person?sgxkId=***&code=***

返回值

{

        "id": "***************",

        "name": "******",

        "idCardNumber": "***************",

        "personType": *,

        "sex": "*",

        "worktype": "****",

        "jobName": ****,

        "team": "****",

        "isHeadMan": "****",

        "companyName": "***************",

        "sgxkId": "***************",

        "builderLicenceNum": "***************",

        "sgxkName": "***************"

    }

2、从平台获取人员照片及人脸特征信息

功能描述:从宜昌实名制平台获取已派工进出场人员的身份证头像和登记照片信息。

请求报文头(HTTP)GET

http://111.47.65.236:2228/labor/externalCall/personImg?sgxkId=***&code=***&personId=***

返回值

{

    "avatar": "data:image/jpeg;base64,/9j/*******************",

    "images":["data:image/jpeg;base64,/9j/*******************"]

}

3、人员考勤信息上传

功能描述:现场设备提供方将已派工进出场人员的考勤信息实时推送上传至宜昌实名制平台。§ 请求报文头(HTTP)   POST http://111.47.65.236:2228/labor/externalCall/personAttendance§ 请求参数内容(JSON){

“sgxkID”: “*******”,

“code”: “*******”,

“lists”: [{

“id”: “*******”,

“companyName”: “*******”,

“engName”: “*******”,

“idCardNumber”: “*******”,

“clientId”: “*******”,

“name”: “*******”,

“inOrOut”: “*******”,

“verifyTime”: “*******”,

“createTime”: “*******”,

“builderLicenceNum”: “*******”,

“controlMode”: “*******”,

“scenePhotos”: “*******”,

“personType”: “*******”,

“jobName”: “*******”,

“team”: “*******”,

“tempera”: “*******”,

“yearMonth”: “*******”

}]

}

参数名参数类型说明

lists参数名参数类型说明

返回值{    “msg”: “接收人员考勤信息完成!",    "code": 0,    "data": true}

4、人员体温信息上传

功能描述:现场设备提供方将已派工进出场人员在考勤同时测量的体温信息实时推送上传至宜昌实名制平台。

请求报文头

(HTTP)POST http://111.47.65.236:2228/labor/externalCall/personTemperature请求参数内容(JSON)

{

    "sgxkID": "*******",

    "code": "*******",

    "licenseKey": "*******",

    "lists": [

        {

            "id": "*******",

            "personId": "*******",

            "name": "*******",

            "idCardNumber": "*******",

            "sex": "*******",

            "organId": "*******",

            "organName": "*******",

            "tempera": "*******",

            "createTime": "*******",

            "engName": "*******",

            "jlrq": "*******"

         }

     ]

  }

参数名参数类型说明

lists参数名参数类型说明

返回值{    "msg": "接收人员考勤信息完成!",    "code": 0,    "data": true}

说明:当前接口地址为测试地址,经平台技术支持服务单位确认无误后,提供正式接口地址。

五、技术支持

“宜昌市智慧城建系统”从业人员实名制信息管理平台

技术支持服务单位:湖北升思科技股份有限公司