我的書(shū)簽
添加書(shū)簽
移除書(shū)簽務工人(rén)員實名制(zhì)
數(shù)據對接說明(míng)書(shū)
安徽德拓信息科技(jì)有(yǒu)限公司
二零一九年七月
文檔信息
作(zuò) 者：丁鵬程
日 期：2019年7月24日
複 審 人(rén)：
日 期：
密 級：公開(kāi)資料 □內(nèi)部資料 □保密資料 □機密資料
文檔類型：□管理(lǐ)文檔 方案文檔 □計(jì)劃文檔 □需求文檔 □設計(jì)文檔
□測試文檔 □實施文檔 □用戶文檔 □測試文檔 □運維文檔
版本控制(zhì)
| 編号 | 章節名稱 | 說明(míng) | 修訂日期 | 版本号 | 修訂人(rén) | 發布日期 |
|---|---|---|---|---|---|---|
| 01 | 全文 | 新建 | 20190724 | V1.0 | 丁鵬程 | |
| 02 | 部分修改 | 1. 接口考勤照片和(hé)人(rén)員基本信息照片大(dà)小(xiǎo)限制(zhì)（30KB）以及相關字段是否必傳 2.AES加密傳輸存在特殊字符被轉義問題處理(lǐ) |
20191218 | V2.0 | 丁鵬程 | 20191218 |
| 03 | 部分修改 | ### 項目人(rén)員信息接入臨時(shí)表中，人(rén)員電(diàn)話(huà)PHONE改成必填項 |
20200210 | V2.1 | 餘方興 | 20200210 |
| 04 | 部分修改 | 應住建部要求，疫情期間(jiān)，人(rén)員每日考勤增加體(tǐ)溫TEMPERATURE信息 | 20200303 | V2.1.1 | 餘方興 | 20200303 |
版本聲明(míng)
Copyright©2019 安徽德拓信息科技(jì)有(yǒu)限公司版權所有(yǒu)，保留一切權力。
非經本公司書(shū)面許可(kě)，任何單位和(hé)個(gè)人(rén)不得(de)擅自摘抄、複制(zhì)本文檔內(nèi)容的部分或全部，并不得(de)以任何形式傳播
1.編寫目的
本文檔針對務工人(rén)員實名制(zhì)，接收各企業傳過來(lái)的參見單位信息、務工班組信息、人(rén)員進出場(chǎng)信息、人(rén)員考勤信息。接口中的數(shù)據全部采用密文的傳輸方式，使用常用的AES對數(shù)據進行(xíng)加密。
2.數(shù)據接口
- 數(shù)據字段
參建單位信息接入臨時(shí)表
唯一約束：項目施工許可(kě)編号 + 責任主體(tǐ)統一社會(huì)信用代碼 + 責任主體(tǐ)類型
| 接口信息 | ||||
| Endpoint | http://{host}/building/worker/temporary | |||
| Method | /saveProjectCompany | |||
| Version | 1.0 | |||
| 請(qǐng)求方式 | POST請(qǐng)求 + JSON | |||
| 接口說明(míng) | 務工人(rén)員實名制(zhì)參建單位信息接入臨時(shí)表 | |||
| 請(qǐng)求頭 | ||||
| keyCode | 對接方的授權碼（接口提供方提供）需要加密 必傳 | |||
| operationType | 操作(zuò)類型（0：增加 1：删除 2：修改） 必傳 | |||
| keys | 接口密鑰（加密傳輸） 必傳 | |||
| 輸入參數(shù) | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| ID | VARCHAR2(200) | 是 | 對接方參建單位表主鍵 | |
| GC_XKNB | VARCHAR2(18) | 是 | 項目施工許可(kě)編号 | |
| UNIT_NAME | VARCHAR2(200) | 是 | 責任主體(tǐ)名稱（參建單位名稱） | |
| UNIT_ORGCODE | VARCHAR2(50) | 是 | 責任主體(tǐ)統一社會(huì)信用代碼 | |
| UNIT_TYPE | VARCHAR2(18) | 是 | 責任主體(tǐ)類型（提供字典） | |
| UNIT_TYPE_NAME | VARCHAR2(18) | 是 | 責任主體(tǐ)類型名稱 | |
| COMP_FR_NAME | VARCHAR2(200) | 否 | 責任主體(tǐ)法人(rén)代表 | |
| COMP_FR_SFZH | VARCHAR2(18) | 否 | 責任主體(tǐ)法人(rén)身份證号 | |
| COMP_FR_PHONE | VARCHAR2(18) | 否 | 責任主體(tǐ)法人(rén)聯系電(diàn)話(huà) | |
| COMP_RC_LXR | VARCHAR2(200) | 否 | 責任主體(tǐ)日常聯系人(rén) | |
| COMP_RC_LXR_PHONE | VARCHAR2(18) | 否 | 責任主體(tǐ)日常聯系人(rén)聯系電(diàn)話(huà) | |
| COMP_CA_NO | VARCHAR2(50) | 否 | 資質證書(shū)編号 | |
| COMP_CA_DETAIL | VARCHAR2(200) | 否 | 資質項名稱+等級 | |
| DATA_SOURCE | VARCHAR2(100) | 是 | 數(shù)據來(lái)源（授權碼） | |
| 注：數(shù)據在傳輸的時(shí)候注意數(shù)據的最大(dà)長度。以及是否必傳項！ | ||||
| 響應體(tǐ)字段 | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| status | String | 是 | 是否成功(狀态如下：) | |
| msg | String | 是 | 返回消息 | |
| 狀态說明(míng) | ||||
| 成功：200 未授權：401 接口參數(shù)未找到：201 其他錯誤：500 | ||||
- 數(shù)據傳輸格式（示例）
| 接口名稱 | 參建單位接入臨時(shí)庫 |
|---|---|
| 接口提供方 | 安徽德拓 |
| 數(shù)據json (在傳遞組裝好的json的時(shí)候将其加密後在傳輸) | { “infoJsonArr”: [{ “GC_XKNB”: “XKGCBH12345611”, “UNIT_NAME”: “參建單位名稱11”, “UNIT_ORGCODE”: “XJ12345671110”, “UNIT_TYPE”: “141014172001740168”, “UNIT_TYPE_NAME”: “設計(jì)單位11”, “COMP_FR_NAME”: “梁啓樂11”, “COMP_FR_SFZH”: “342401199510048899”, “COMP_FR_PHONE”: “18075095236”, “COMP_RC_LXR”: “丁鵬程”, “COMP_RC_LXR_PHONE”: “18012345678”, “COMP_CA_NO”: “ZZZSNO123456”, “COMP_CA_DETAIL”: “勘查設計(jì)資質項三級”, “STATUS”: “0”, “ID”: “190123412341234123” }] } |
| 返回結果 | 返回結果解密之後格式： { “status”: “200”, “msg”: “”//返回消息 } |
| 特殊說明(míng) | 暫無 |
務工班組信息接入臨時(shí)表
唯一約束：項目施工許可(kě)編号 +用工單位統一社會(huì)信用代碼+ 責任主體(tǐ)類型 +責任主體(tǐ)類型 + 班組編号
| 接口信息 | ||||
| Endpoint | http://{host}/building/worker/temporary | |||
| Method | /saveProjectTeam | |||
| Version | 1.0 | |||
| 請(qǐng)求方式 | POST請(qǐng)求 + JSON | |||
| 接口說明(míng) | 務工人(rén)員實名制(zhì)務工班組信息接入臨時(shí)表 | |||
| 請(qǐng)求頭 | ||||
| keyCode | 對接方的授權碼（接口提供方提供）需要加密 必傳 | |||
| operationType | 操作(zuò)類型（0：增加 1：删除 2：修改） 必傳 | |||
| keys | 接口密鑰（加密傳輸） 必傳 | |||
| 輸入參數(shù) | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| ID | VARCHAR2(200) | 是 | 對接方務工班組表主鍵 | |
| GC_XKNB | VARCHAR2(18) | 是 | 項目施工許可(kě)編号 | |
| UNIT_ORGCODE | VARCHAR2(200) | 是 | 用工單位統一社會(huì)信用代碼 | |
| GROUP_NAME | VARCHAR2(100) | 是 | 班組名稱 | |
| GROUP_CODE | VARCHAR2(100) | 是 | 班組編号 | |
| GROUP_FZR_NAME | VARCHAR2(18) | 是 | 班組負責人(rén) | |
| GROUP_FZR_IDCARD | VARCHAR2(18) | 是 | 班組負責人(rén)身份證号 | |
| GROUP_FZR_MOBILE | VARCHAR2(15) | 是 | 班組負責人(rén)手機 | |
| WORK_TYPE | VARCHAR2(18) | 是 | 人(rén)員在項目中的工種ID(班組類型)（提供字典） | |
| WORK_TYPE_NAME | VARCHAR2(100) | 是 | 人(rén)員在項目中的工種名稱（班組類型名稱） | |
| LATITUDE | VARCHAR2(50) | 否 | 班組考勤設定的緯度 | |
| LONGITUDE | VARCHAR2(200) | 否 | 班組考勤設定的經度 | |
| UNIT_TYPE | VARCHAR2(18) | 是 | 責任主體(tǐ)類型（在項目 上(shàng)擔任的角色 提供字典)） | |
| DATA_SOURCE | VARCHAR2(100) | 是 | 數(shù)據來(lái)源（授權碼） | |
| UNIT_NAME | VARCHAR2(50) | 是 | 責任主體(tǐ)名稱 | |
| 注：數(shù)據在傳輸的時(shí)候注意數(shù)據的最大(dà)長度。以及是否必傳項！ | ||||
| 響應體(tǐ)字段 | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| status | Stirng | 是 | 是否成功（狀态如下） | |
| msg | String | 是 | 返回消息 | |
| 狀态說明(míng) | ||||
| 成功：200 未授權：401 接口參數(shù)未找到：201 其他錯誤：500 | ||||
- 數(shù)據傳輸格式（示例）
| 接口名稱 | 務工班組接入臨時(shí)庫 |
|---|---|
| 接口提供方 | 安徽德拓 |
| 數(shù)據json (在傳遞組裝好的json的時(shí)候将其加密後在傳輸) | { “infoJsonArr”: [{ “GC_XKNB”: “XKGCBH123456111”, “UNIT_ORGCODE”: “XJ1111222”, “GROUP_NAME”: “班組名稱22”, “GROUP_CODE”: “BZ12345611”, “GROUP_FZR_NAME”: “梁啓樂22”, “GROUP_FZR_IDCARD”: “342401199510048899”, “COMP_FR_NAME”: “梁啓樂22”, “COMP_FR_SFZH”: “342401199510048899”, “GROUP_FZR_MOBILE”: “18075095231”, “WORK_TYPE”: “180810130127641550”, “WORK_TYPE_NAME”: “爆破工”, “LATITUDE”: “111”, “LONGITUDE”: “122”, “UNIT_TYPE”: “141028012501737704”, “STATUS”: “0”, “ID”: “190123412341234123” }] } |
| 返回結果 | 返回結果解密之後格式： { “status”: “200”, “msg”: “”//返回消息 } |
| 特殊說明(míng) | 暫無 |
項目人(rén)員信息接入臨時(shí)表
唯一約束：身份證号 + 班組編号 + 責任主體(tǐ)類型 + 用工單位統一社會(huì)信用代碼 + 項目許可(kě)證編号
| 接口信息 | ||||
| Endpoint | http://{host}/building/worker/temporary | |||
| Method | /saveProjectPerson | |||
| Version | 1.0 | |||
| 請(qǐng)求方式 | POST請(qǐng)求 + JSON | |||
| 接口說明(míng) | 務工人(rén)員實名制(zhì)項目人(rén)員信息接入臨時(shí)表 | |||
| 請(qǐng)求頭 | ||||
| keyCode | 對接方的授權碼（接口提供方提供）需要加密 必傳 | |||
| operationType | 操作(zuò)類型（0：增加 1：删除 2：修改） 必傳 | |||
| keys | 接口密鑰（加密傳輸） 必傳 | |||
| 輸入參數(shù) | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| ID | VARCHAR2(200) | 是 | 對接方務工人(rén)員表主鍵 | |
| CARD_NO | VARCHAR2(18) | 是 | 身份證号 | |
| NAME | VARCHAR2(500) | 是 | 姓名 | |
| NATION | VARCHAR2(50) | 是 | 民族(提供字典) | |
| SEX | VARCHAR2(20) | 是 | 性别（1：男；0：女） | |
| BIRTHDAY | DATE | 是 | 出生(shēng)日期 | |
| IDLATELY | VARCHAR2(18) | 否 | 身份證有(yǒu)效期（yyyy-MM-dd至yyyy-MM-dd 或 yyyy-MM-dd至長期 ） | |
| ADDRESS | VARCHAR2(100) | 是 | 戶籍所在地 | |
| BMP | VARCHAR2(50) | 是 | 身份證簽發機關 | |
| SWIPE_TIME | DATE | 是 | 采集時(shí)間(jiān) | |
| GROUP_CODE | VARCHAR2(50) | 是 | 班組編号 | |
| BANK | VARCHAR2(50) | 否 | 銀行(xíng)id（提供字典） | |
| BANK_CARD | VARCHAR2(50) | 否 | 銀行(xíng)卡号 | |
| UNIT_ORGCODE | VARCHAR2(50) | 是 | 用工單位統一社會(huì)信用代碼 | |
| GC_XKNB | VARCHAR2(50) | 是 | 項目許可(kě)證編号 | |
| PHONE | VARCHAR2(50) | 是 | 手機号碼 | |
| DATA_SOURCE | VARCHAR2(200) | 是 | 數(shù)據來(lái)源（授權碼） | |
| 注：數(shù)據在傳輸的時(shí)候注意數(shù)據的最大(dà)長度。以及是否必傳項！ | ||||
| 響應體(tǐ)字段 | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| status | Stirng | 是 | 是否成功（狀态如下） | |
| msg | String | 是 | 返回消息 | |
| 狀态說明(míng) | ||||
| 成功：200 未授權：401 接口參數(shù)未找到：201 其他錯誤：500 | ||||
- 數(shù)據傳輸格式（示例）
| 接口名稱 | 務工人(rén)員接入臨時(shí)庫 |
|---|---|
| 接口提供方 | 安徽德拓 |
| 數(shù)據json (在傳遞組裝好的json的時(shí)候将其加密後在傳輸) | { “infoJsonArr”: [{ “CARD_NO”: “342401199510048899”, “NAME”: “梁啓樂”, “NATION”: “130305085700665993”, “SEX”: “1”, “BIRTHDAY”: “2018-12-03 12:04:41”, “IDLATELY”: “2026-12-12”, “ADDRESS”: “安徽省六安市11”, “BMP”: “金安區(qū)政府11”, “SWIPE_TIME”: “2019-07-19 16:05:37”, “GROUP_CODE”: “BZ123456”, “BANK”: “190323142828035179”, “BANK_CARD”: “62284812312312111111”, “UNIT_ORGCODE”: “XJ111111”, “PHONE”: “18075095236”, “GC_XKNB”: “XKGCNB123456”, “STATUS”: “0”, “ID”: “190123412341234123” }] } |
| 返回結果 | 返回結果解密之後格式： { “status”: “200”, “msg”: “”//返回消息 } |
| 特殊說明(míng) | 暫無 |
4.人(rén)員進退場(chǎng)信息接入臨時(shí)表
| 接口信息 | ||||
| Endpoint | http://{host}/building/worker/temporary | |||
| Method | /saveInout | |||
| Version | 1.0 | |||
| 請(qǐng)求方式 | POST請(qǐng)求 + JSON | |||
| 接口說明(míng) | 務工人(rén)員實名制(zhì)人(rén)員進退場(chǎng)信息接入臨時(shí)表 | |||
| 請(qǐng)求頭 | ||||
| keyCode | 對接方的授權碼（接口提供方提供）需要加密 必傳 | |||
| operationType | 操作(zuò)類型（0：增加 1：删除 2：修改） 必傳 | |||
| keys | 接口密鑰（加密傳輸） 必傳 | |||
| 輸入參數(shù) | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| ID | VARCHAR2(200) | 是 | 對接方人(rén)員進出場(chǎng)表主鍵 | |
| CARD_NO | VARCHAR2(18) | 是 | 身份證号 | |
| PER_FLAG | CHAR(1) | 是 | 人(rén)員标記：1：正常在場(chǎng) 2：已經退場(chǎng) | |
| ENTER_TIME | DATE | 是 | 進場(chǎng)刷身份證時(shí)間(jiān) | |
| OUT_TIME | DATE | 否 | 退場(chǎng)刷身份證時(shí)間(jiān) | |
| SGXKZBH | VARCHAR2(50) | 是 | 施工許可(kě)證編号 | |
| XKGC_NAME | VARCHAR2(500) | 否 | 項目名稱 | |
| GROUP_NO | VARCHAR2(50) | 是 | 班組編号 | |
| WORK_GROUP_NAME | VARCHAR2(500) | 否 | 班組名稱 | |
| UNIT_ORGCODE | VARCHAR2(50) | 是 | 用工單位統一社會(huì)信用代碼 | |
| COMP_NAME | VARCHAR2(500) | 是 | 用工單位名稱 | |
| ENTER_MACHINE_NO | VARCHAR2(20) | 是 | 進場(chǎng)登記的設備編号 | |
| DATA_SOURCE | VARCHAR2(200) | 是 | 數(shù)據來(lái)源（授權碼） | |
| 注：數(shù)據在傳輸的時(shí)候注意數(shù)據的最大(dà)長度。以及是否必傳項！ | ||||
| 響應體(tǐ)字段 | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| status | Stirng | 是 | 是否成功（狀态如下） | |
| msg | String | 是 | 返回消息 | |
| 狀态說明(míng) | ||||
| 成功：200 未授權：401 接口參數(shù)未找到：201 其他錯誤：500 | ||||
- 數(shù)據傳輸格式（示例）
| 接口名稱 | 務工人(rén)員實名制(zhì)人(rén)員進退場(chǎng)信息接入臨時(shí)表 |
|---|---|
| 接口提供方 | 安徽德拓 |
| 數(shù)據json (在傳遞組裝好的json的時(shí)候将其加密後在傳輸) | { “infoJsonArr”: [{ “CARD_NO”: “342401199510048899”, “PER_FLAG”: “2”, “ENTER_TIME”: “2019-06-23 09:00:00”, “OUT_TIME”: “2019-06-23 18:00:00”, “ENTER_MACHINE_NO”: “NB222222”, “SGXKZBH”: “XKBH654321”, “XKGC_NAME”: “許可(kě)工程名稱測試1”, “GROUP_NO”: “BZ1234561”, “WORK_GROUP_NAME”: “測試班組名稱”, “UNIT_ORGCODE”: “343562312313129090”, “COMP_NAME”: “冗餘用工單位名稱”, “REMAKE”: “備注1”, “STATUS”: “0”, “ID”: “190123412341234123” }] } |
| 返回結果 | 返回結果解密之後格式： { “status”: “200”, “msg”: “”//返回消息 } |
| 特殊說明(míng) | 暫無 |
5.人(rén)員考勤信息接入臨時(shí)表
| 接口信息 | ||||
| Endpoint | http://{host}/building/worker/temporary | |||
| Method | /attendanceInfo | |||
| Version | 1.0 | |||
| 請(qǐng)求方式 | POST請(qǐng)求 + JSON | |||
| 接口說明(míng) | 務工人(rén)員實名制(zhì)人(rén)員考勤信息接入臨時(shí)表 | |||
| 請(qǐng)求頭 | ||||
| keyCode | 對接方的授權碼（接口提供方提供）需要加密 必傳 | |||
| operationType | 操作(zuò)類型（0：增加 1：删除 2：修改） 必傳 | |||
| keys | 接口密鑰（加密傳輸） 必傳 | |||
| 輸入參數(shù) | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| ID | VARCHAR2(200) | 是 | 對接方人(rén)員考勤表主鍵（考勤信息和(hé)考勤照片關聯鍵） | |
| SGXKZBH | VARCHAR2(50) | 是 | 施工許可(kě)證編号 | |
| PERSON_NAME | VARCHAR2(500) | 是 | 人(rén)員姓名 | |
| CARD_NO | VARCHAR2(50) | 是 | 身份證号 | |
| KQ_TYPE | VARCHAR2(1) | 是 | 考勤類型（0進，1出） | |
| KQ_TIME | DATE | 是 | 考勤時(shí)間(jiān)（設備上(shàng)傳） | |
| GROUP_NO | VARCHAR2(50) | 是 | 班組編号 | |
| UNIT_ORGCODE | VARCHAR2(50) | 是 | 用工單位統一社會(huì)信用代碼 | |
| WORK_GROUP_NAME | VARCHAR2(500) | 否 | 班組名稱（冗餘字段） | |
| COMP_NAME | VARCHAR2(500) | 否 | 用工單位名稱 | |
| XKGC_NAME | VARCHAR2(500) | 否 | 項目名稱（冗餘字段） | |
| LATITUDE | VARCHAR2(200) | 否 | 考勤時(shí)的緯度 | |
| LONGITUDE | VARCHAR2(200) | 否 | 考勤時(shí)的經度 | |
| DATA_SOURCE | VARCHAR2(200) | 是 | 數(shù)據來(lái)源（授權碼） | |
| UNIT_TYPE | VARCHAR2(18) | 是 | 責任主體(tǐ)類型（在項目 上(shàng)擔任的角色 提供字典)） | |
| MACHINE_NO | VARCHAR2(20) | 是 | 設備編号 | |
| TEMPERATURE | VARCHAR2(20) | 體(tǐ)溫信息/攝氏度 | ||
| 注：數(shù)據在傳輸的時(shí)候注意數(shù)據的最大(dà)長度。以及是否必傳項！ | ||||
| 響應體(tǐ)字段 | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| status | Stirng | 是 | 是否成功（狀态如下） | |
| msg | String | 是 | 返回消息 | |
| 狀态說明(míng) | ||||
| 成功：200 未授權：401 接口參數(shù)未找到：201 其他錯誤：500 | ||||
- 數(shù)據傳輸格式（示例）
| 接口名稱 | 務工人(rén)員實名制(zhì)人(rén)員考勤信息接入臨時(shí)表 |
|---|---|
| 接口提供方 | 安徽德拓 |
| 數(shù)據json (在傳遞組裝好的json的時(shí)候将其加密後在傳輸) | { “infoJsonArr”: [{ “SGXKZBH”: “XKGC123456”, “PERSON_NAME”: “梁啓樂”, “CARD_NO”: “342401199510048899”, “KQ_TYPE”: “0”, “KQ_TIME”: “2019-06-23 09:00:00”, “GROUP_NO”: “BZ123456”, “UNIT_ORGCODE”: “XJ111111”, “WORK_GROUP_NAME”: “測試班組名稱”, “COMP_NAME”: “測試單位”, “XKGC_NAME”: “許可(kě)工程名稱測試1”, “LATITUDE”: “121”, “LONGITUDE”: “122”, “MACHINE_NO”: “SN5241441”, “UNIT_TYPE”: “141028012501737704”, “STATUS”: “0”, “TEMPERATURE”: “36.5”, “ID”: “190123412341234123” }] } |
| 返回結果 | 返回結果解密之後格式： { “status”: “200”, “msg”: “”//返回消息 } |
| 特殊說明(míng) | 暫無 |
6.人(rén)員考勤照片信息接入臨時(shí)表
| 接口信息 | ||||
| Endpoint | http://{host}/building/worker/temporary | |||
| Method | /personKqImage | |||
| Version | 1.0 | |||
| 請(qǐng)求方式 | POST請(qǐng)求 + JSON | |||
| 接口說明(míng) | 務工人(rén)員實名制(zhì)人(rén)員考勤照片信息接入臨時(shí)表 | |||
| 請(qǐng)求頭 | ||||
| keyCode | 對接方的授權碼（接口提供方提供）需要加密 必傳 | |||
| operationType | 操作(zuò)類型（0：增加 1：删除 2：修改） 必傳 | |||
| keys | 接口密鑰（加密傳輸） 必傳 | |||
| 輸入參數(shù) | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| ID | VARCHAR2(200) | 是 | 對接方人(rén)員考勤表主鍵（考勤信息和(hé)考勤照片關聯鍵） | |
| PERSON_NAME | VARCHAR2(500) | 是 | 人(rén)員姓名 | |
| CARD_NO | VARCHAR2(50) | 是 | 身份證号 | |
| SGXKZBH | VARCHAR2(50) | 是 | 施工許可(kě)證編号 | |
| GROUP_NO | VARCHAR2(50) | 是 | 班組編号 | |
| UNIT_ORGCODE | VARCHAR2(50) | 是 | 用工單位統一社會(huì)信用代碼 | |
| KQ_PHOTO | CLOB | 是 | 考勤照片（base64） | |
| DATA_SOURCE | VARCHAR2(200) | 是 | 數(shù)據來(lái)源（授權碼） | |
| PERSON_KQ_ID | VARCHAR2(200) | 否 | 冗餘字段 暫不使用 | |
| 注：數(shù)據在傳輸的時(shí)候注意數(shù)據的最大(dà)長度。以及是否必傳項！ | ||||
| 響應體(tǐ)字段 | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| status | Stirng | 是 | 是否成功（狀态如下） | |
| msg | String | 是 | 返回消息 | |
| 狀态說明(míng) | ||||
| 成功：200 未授權：401 接口參數(shù)未找到：201 其他錯誤：500 | ||||
- 數(shù)據傳輸格式（示例）
| 接口名稱 | 務工人(rén)員實名制(zhì)人(rén)員考勤照片信息接入臨時(shí)表 |
|---|---|
| 接口提供方 | 安徽德拓 |
| 數(shù)據json (在傳遞組裝好的json的時(shí)候将其加密後在傳輸) | { “infoJsonArr”: [{ “SGXKZBH”: “XKGC123456”, “PERSON_NAME”: “梁啓樂”, “CARD_NO”: “342401199510048899”, “GROUP_NO”: “BZ123456”, “UNIT_ORGCODE”: “XJ111111”, “KQ_PHOTO”: “base64”, “DATA_SOURCE”: “fdfdfddfdff”， “ PERSON_KQ_ID “: “” }] } |
| 返回結果 | 返回結果解密之後格式： { “status”: “200”, “msg”: “”//返回消息 } |
| 特殊說明(míng) | 暫無 |
7.人(rén)員照片信息接入臨時(shí)表
IDPICTURE：身份證上(shàng)采集的照片 其他項目的照片沒有(yǒu)可(kě)以傳相同的人(rén)臉照片
| 接口信息 | ||||
| Endpoint | http://{host}/building/worker/temporary | |||
| Method | /personImage | |||
| Version | 1.0 | |||
| 請(qǐng)求方式 | POST請(qǐng)求 + JSON | |||
| 接口說明(míng) | 務工人(rén)員實名制(zhì)人(rén)員照片信息接入臨時(shí)表 | |||
| 請(qǐng)求頭 | ||||
| keyCode | 對接方的授權碼（接口提供方提供）需要加密 必傳 | |||
| operationType | 操作(zuò)類型（0：增加 1：删除 2：修改） 必傳 | |||
| keys | 接口密鑰（加密傳輸） 必傳 | |||
| 輸入參數(shù) | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| ID | VARCHAR2(200) | 是 | 對接方人(rén)員基本信息表主鍵 | |
| NAME | VARCHAR2(500) | 是 | 人(rén)員姓名 | |
| CARD_NO | VARCHAR2(18) | 是 | 身份證号 | |
| FACE_DATA | CLOB | 是 | 人(rén)臉特征數(shù)據 | |
| PHOTO1 | CLOB | 是 | 人(rén)臉特征照片1 | |
| PHOTO2 | CLOB | 是 | 人(rén)臉特征照片2 | |
| PHOTO3 | CLOB | 是 | 人(rén)臉特征照片3 | |
| PHOTO4 | CLOB | 是 | 人(rén)臉特征照片4 | |
| PHOTO5 | CLOB | 是 | 人(rén)臉特征照片5 | |
| PHOTO6 | CLOB | 是 | 人(rén)臉特征照片6 | |
| IDPICTURE | CLOB | 是 | 身份證照片（身份證上(shàng)面的照片） | |
| DATA_SOURCE | VARCHAR2(50) | 是 | 數(shù)據來(lái)源（授權碼） | |
| GROUP_PERSON_ID | VARCHAR2(18) | 否 | 冗餘字段（暫不使用） | |
| 注：數(shù)據在傳輸的時(shí)候注意數(shù)據的最大(dà)長度。以及是否必傳項！ | ||||
| 響應體(tǐ)字段 | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| status | Stirng | 是 | 是否成功（狀态如下） | |
| msg | String | 是 | 返回消息 | |
| 狀态說明(míng) | ||||
| 成功：200 未授權：401 接口參數(shù)未找到：201 其他錯誤：500 | ||||
- 數(shù)據傳輸格式（示例）
| 接口名稱 | 務工人(rén)員實名制(zhì)人(rén)員照片信息接入臨時(shí)表 |
|---|---|
| 接口提供方 | 安徽德拓 |
| 數(shù)據json (在傳遞組裝好的json的時(shí)候将其加密後在傳輸) | { { “infoJsonArr”: [{ “CARD_NO”: “342401199510048899”, “NAME”: “梁啓樂”, “FACE_DATA”: “”, “GROUP_NO”: “BZ123456”, “PHOTO1”: “base64”, “PHOTO2”: “base64”, “PHOTO3”: “base64”, “PHOTO4”: “base64”, “PHOTO5”: “base64”, “PHOTO6”: “base64”, “IDPICTURE”: “base64”, “DATA_SOURCE”: “fdfdfddfdff”, “ID”: “fdfdfddfdff”， “ GROUP_PERSON_ID “: “” }] } |
| 返回結果解密之後格式： { “status”: “200”, “msg”: “”//返回消息 } |
|
| 特殊說明(míng) | 暫無 |
7.項目信息下發接口
| 接口信息 | ||||
| Endpoint | http://{host}/building/worker/temporary | |||
| Method | /getXkgcInfo | |||
| Version | 1.0 | |||
| 請(qǐng)求方式 | POST請(qǐng)求 + JSON | |||
| 接口說明(míng) | 項目信息下發接口 | |||
| 請(qǐng)求頭 | ||||
| keyCode | 對接方的授權碼（接口提供方提供）需要加密 必傳 | |||
| keys | 接口密鑰（加密傳輸） 必傳 | |||
| 輸入參數(shù) | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| gc_xknb | VARCHAR2(50) | 是 | 施工許可(kě)編号 | |
| gc_sgxkzffdw | VARCHAR2(50) | 是 | 施工許可(kě)發證機關 | |
| 響應體(tǐ)字段 | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| status | Stirng | 是 | 是否成功（狀态如下） | |
| msg | String | 是 | 返回消息 | |
| JsonArr | String | 是 | 數(shù)據信息 | |
| jsonArr包含字段 | ||||
| GC_NAME | 施工許可(kě)工程名稱 | |||
| GC_XKNB | 施工許可(kě)證編号 | |||
| GC_TYPE | 工程類型 | |||
| GC_TYPE_NAME | 工程類型名稱 | |||
| GC_AREA | 工程所在區(qū)劃 | |||
| GC_AREA_NAME | 工程所在區(qū)劃名稱 | |||
| GC_ADDR | 工程詳細地址 | |||
| GC_JZMJ | 建築規模（建築面積平方米，長度米） | |||
| GC_JHKGRQ | 計(jì)劃開(kāi)工日期 | |||
| GC_JHJGRQ | 計(jì)劃竣工日期 | |||
| GC_SGXKZFFRQ | 發證日期 | |||
| GC_ISXKZ | 是否補辦證（1是，0否） | |||
| GC_LNG | 許可(kě)項目經度 | |||
| GC_LAT | 許可(kě)項目緯度 | |||
| GC_FLAG | 1:在建；2:竣工；3:停工整改 | |||
| GC_SGXKZFFDW_NAME | 施工許可(kě)證發證單位名稱 | |||
| GC_SGXKZFFDW | 施工許可(kě)證發證發證單位id | |||
| GC_BZ | 備注 | |||
| GC_HTJ | 施工許可(kě)工程名稱 | |||
| 狀态說明(míng) | ||||
| 成功：200 未授權：401 接口參數(shù)未找到：201 其他錯誤：500 | ||||
- 數(shù)據傳輸格式（示例）
| 接口名稱 | 項目信息下發接口 |
|---|---|
| 接口提供方 | 安徽德拓 |
| 數(shù)據json (在傳遞組裝好的json的時(shí)候将其加密後在傳輸) | { “gc_xknb”: “342401199510048899”, “gc_sgxkzffdw”: “發證機關” } |
| 返回結果 | 返回結果解密之後格式： { “status”: “200”, “msg”: “”//返回消息， “jsonArray”:[{ “GC_NAME”:””; …………… }] } |
| 特殊說明(míng) | 暫無 |
8.參建單位轉入正式庫
| 接口信息 | ||||
| Endpoint | http://{host}/building/worker/formal | |||
| Method | /changeProjectCompany | |||
| Version | 1.0 | |||
| 請(qǐng)求方式 | POST請(qǐng)求 | |||
| 接口說明(míng) | 參建單位轉入正式庫 | |||
| 請(qǐng)求頭 | ||||
| keyCode | 對接方的授權碼（接口提供方提供）需要加密 必傳 | |||
| keys | 接口密鑰（加密傳輸） 必傳 | |||
| uniquenessId | 對接方參建單位表主鍵（用于單條記錄入正式庫 加密）非必傳 | |||
| 響應體(tǐ)字段 | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| status | Stirng | 是 | 是否成功（狀态如下） | |
| msg | String | 是 | 返回消息 | |
| 狀态說明(míng) | ||||
| 成功：200 未授權：401 接口參數(shù)未找到：201 其他錯誤：500 | ||||
9.項目班組轉入正式庫
| 接口信息 | ||||
| Endpoint | http://{host}/building/worker/formal | |||
| Method | /changeProjectTeam | |||
| Version | 1.0 | |||
| 請(qǐng)求方式 | POST請(qǐng)求 | |||
| 接口說明(míng) | 項目班組轉入正式庫 | |||
| 請(qǐng)求頭 | ||||
| keyCode | 對接方的授權碼（接口提供方提供）需要加密 必傳 | |||
| keys | 接口密鑰（加密傳輸） 必傳 | |||
| uniquenessId | 對接方班組表主鍵（用于單條記錄入正式庫 加密）非必傳 | |||
| 響應體(tǐ)字段 | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| status | Stirng | 是 | 是否成功（狀态如下） | |
| msg | String | 是 | 返回消息 | |
| 狀态說明(míng) | ||||
| 成功：200 未授權：401 接口參數(shù)未找到：201 其他錯誤：500 | ||||
10.人(rén)員進出場(chǎng)轉入正式庫
| 接口信息 | ||||
| Endpoint | http://{host}/building/worker/formal | |||
| Method | /changeInout | |||
| Version | 1.0 | |||
| 請(qǐng)求方式 | POST請(qǐng)求 | |||
| 接口說明(míng) | 人(rén)員進出場(chǎng)轉入正式庫 | |||
| 請(qǐng)求頭 | ||||
| keyCode | 對接方的授權碼（接口提供方提供）需要加密 必傳 | |||
| keys | 接口密鑰（加密傳輸） 必傳 | |||
| uniquenessId | 對接方人(rén)員進出場(chǎng)表主鍵（用于單條記錄入正式庫 加密）非必傳 | |||
| 響應體(tǐ)字段 | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| status | Stirng | 是 | 是否成功（狀态如下） | |
| msg | String | 是 | 返回消息 | |
| 狀态說明(míng) | ||||
| 成功：200 未授權：401 接口參數(shù)未找到：201 其他錯誤：500 | ||||
11.人(rén)員考勤轉入正式庫
| 接口信息 | ||||
| Endpoint | http://{host}/building/worker/formal | |||
| Method | /changeAttendanceInfo | |||
| Version | 1.0 | |||
| 請(qǐng)求方式 | POST請(qǐng)求 | |||
| 接口說明(míng) | 人(rén)員考勤轉入正式庫 | |||
| 請(qǐng)求頭 | ||||
| keyCode | 對接方的授權碼（接口提供方提供）需要加密 必傳 | |||
| keys | 接口密鑰（加密傳輸） 必傳 | |||
| uniquenessId | 對接方考勤表主鍵（用于單條記錄入正式庫 加密）非必傳 | |||
| 響應體(tǐ)字段 | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| status | Stirng | 是 | 是否成功（狀态如下） | |
| msg | String | 是 | 返回消息 | |
| 狀态說明(míng) | ||||
| 成功：200 未授權：401 接口參數(shù)未找到：201 其他錯誤：500 | ||||
12.人(rén)員基本信息轉入正式庫
| 接口信息 | ||||
| Endpoint | http://{host}/building/worker/formal | |||
| Method | /pushSmzPersonInfo | |||
| Version | 1.0 | |||
| 請(qǐng)求方式 | POST請(qǐng)求 | |||
| 接口說明(míng) | 人(rén)員基本信息轉入正式庫 | |||
| 請(qǐng)求頭 | ||||
| keyCode | 對接方的授權碼（接口提供方提供）需要加密 必傳 | |||
| keys | 接口密鑰（加密傳輸） 必傳 | |||
| uniquenessId | 對接方人(rén)員基本信息表主鍵（用于單條記錄入正式庫 加密）非必傳 | |||
| 響應體(tǐ)字段 | ||||
| 名稱 | 類型 | 是否必需 | 備注 | |
| status | Stirng | 是 | 是否成功（狀态如下） | |
| msg | String | 是 | 返回消息 | |
| 狀态說明(míng) | ||||
| 成功：200 未授權：401 接口參數(shù)未找到：201 其他錯誤：500 | ||||
3.對接相關地址
測試地址：
正式地址：
測試密鑰、正式密鑰請(qǐng)寫申請(qǐng)（申請(qǐng)表樣式如下），發送到1164999615@qq.com
授權申請(qǐng)表
| 系統名稱 | 合肥市務工人(rén)員實名制(zhì)平台 | ||
| 申請(qǐng)單位 | **信息科技(jì)公司（需填寫，加蓋公章） | ||
| 軟件名稱 | 比如“易聯寶實名制(zhì)平台” 需填寫 | ||
| 申請(qǐng)時(shí)間(jiān) | 需填寫 | 聯系人(rén) | 需填寫 |
| 郵箱 | 需填寫 | 聯系電(diàn)話(huà) | 需填寫 |
| 申請(qǐng)描述 | |||
注：請(qǐng)準确填寫聯系方式，用于接收授權賬戶信息
4.常見問題
1．調用接口的時(shí)候請(qǐng)求頭和(hé)請(qǐng)求體(tǐ)必須加密。數(shù)據不加密接口返回500
2．接口中可(kě)空(kōng)的字段都必須拼接在json中，字段為(wèi)空(kōng)的實例（｛”demo”, ””｝）直接使用 “”即可(kě)
3．确保數(shù)據先入臨時(shí)庫，在将數(shù)據轉入正式庫，人(rén)員基本信息和(hé)考勤基本信息在轉入正式庫的時(shí)候确保對應的圖片也已經轉入臨時(shí)庫了
4．已經轉入正式庫的數(shù)據無法删除和(hé)修改，在确保臨時(shí)庫中數(shù)據準确無誤，調用接口轉入正式庫（數(shù)據尚未轉入正式庫可(kě)以進行(xíng)删除和(hé)修改操作(zuò)）
5．所有(yǒu)的時(shí)間(jiān)格式按照 yyyy-MM-dd HH:mm:ss的格式轉換
6．上(shàng)傳參建單位數(shù)據的時(shí)候，統一使用測試施工許可(kě)證編号（測試環境：340111201910300101-SX-001）
7．上(shàng)傳數(shù)據注意數(shù)據關聯 參見單位 》參建單位下務工班組 》班組下人(rén)員
8．在推送人(rén)員進出場(chǎng)須知：首先将人(rén)員進出場(chǎng)的信息推送到臨時(shí)庫，再調用轉入正式庫，該人(rén)員出場(chǎng)後，調用修改接口修改之前的進場(chǎng)數(shù)據，改變進場(chǎng)狀态，更新上(shàng)出場(chǎng)時(shí)間(jiān)，在調用接口将數(shù)據推送到正式庫
9.其他錯誤根據接口返回的數(shù)據進行(xíng)調整上(shàng)傳數(shù)據
10.人(rén)員基本信息照片和(hé)人(rén)員考勤照片的大(dà)小(xiǎo)添加限制(zhì)，最大(dà)不能超過30KB，超過大(dà)小(xiǎo)的圖片不接受，在上(shàng)傳的時(shí)候需要将圖片進行(xíng)壓縮處理(lǐ)。
5.AES加密問題處理(lǐ)
1.在将返回的數(shù)據解密後出現解密後的返回值為(wèi) null，則是因為(wèi)AES在加密後傳輸特殊字符被轉義。Java使用如下的解決方法，直接替換AES加密工具包。C#可(kě)以将加密後的數(shù)據先進行(xíng)轉化。（将加密後的數(shù)據 /轉化成 _a +轉成_b =轉成_c）解密的時(shí)候反過來(lái)
