深圳市建筑業(yè)實名制和分賬制管理平臺與第三方實名制系統(tǒng)集

1、深圳市建筑業(yè)實名制和分賬制管理平臺與第三方實名制系統(tǒng)集成方案深圳市建筑業(yè)實名制和分賬制管理平臺與第三方實名制系統(tǒng)集成方案（V2.2.4）二一六年十二月修改控制表序號修改章節(jié)修訂類型版本修改內(nèi)容修改人修改日期審批人審批日期1首版V0.9王元元2016-12-262改進V0.9.6郭爽2017-05-103修改V郭爽2017-6-14.43.2.2修改V2人員類型數(shù)據(jù)字典 API協(xié)議版本，apiversion可選值:1.1，取消1.0林強2019-1-1753.2.3修改V2.1更新考勤實時上傳林強2019-2-20刪除V2.2關閉工資上傳、合同上傳接口林強20

2、19-3-1173.2.3修改V2.2.1非“在建”工程，不能上傳考勤林強2019-04-0183.2.3修改V2.2.2way取值范圍：1、2、3禁用上傳安全教育記錄接口林強2019-07-193.1.2刪除V2.2.3關閉第3方舊的班組接口林強2019-8-203.2.2修改V2.2.3去掉上傳人員接口中的班組名稱字段林強2019-8-20V2.2.4文檔格式調(diào)整林強2019-9-9注： “修訂類型”為“首版”、“添加”、“刪除”和“修改”四種類型。目錄 HYPERLINK l _Toc28210_WPSOffice_Level1 1. 集成總體業(yè)務流程4 HYPERLINK l _Toc

3、31278_WPSOffice_Level2 圖 1實名分賬平臺與第三方系統(tǒng)集成關系4 HYPERLINK l _Toc11872_WPSOffice_Level2 1.2. 注冊工程信息4 HYPERLINK l _Toc4395_WPSOffice_Level2 1.3. 完善單位信息5 HYPERLINK l _Toc1239_WPSOffice_Level2 1.4. 獲取工種、人員類別等數(shù)據(jù)字典信息5 HYPERLINK l _Toc18201_WPSOffice_Level2 1.5. 上報人員實名制信息5 HYPERLINK l _Toc5166_WPSOffice_Level2

4、 1.6. 上傳考勤信息5 HYPERLINK l _Toc28240_WPSOffice_Level2 1.7. 上傳安全教育培訓記錄5 HYPERLINK l _Toc25849_WPSOffice_Level2 1.8. 上傳工資發(fā)放記錄6 HYPERLINK l _Toc22083_WPSOffice_Level2 1.9. 人員離場6 HYPERLINK l _Toc31278_WPSOffice_Level1 2. API調(diào)用說明6 HYPERLINK l _Toc5445_WPSOffice_Level2 2.1. 集成方式6 HYPERLINK l _Toc10124_WPSO

5、ffice_Level2 2.2. 調(diào)用方式說明7 HYPERLINK l _Toc11011_WPSOffice_Level2 2.3. 調(diào)用參數(shù)7 HYPERLINK l _Toc31278_WPSOffice_Level3 系統(tǒng)參數(shù)7 HYPERLINK l _Toc11872_WPSOffice_Level3 應用參數(shù)7 HYPERLINK l _Toc4395_WPSOffice_Level3 簽名signature7 HYPERLINK l _Toc1239_WPSOffice_Level3 注意事項8 HYPERLINK l _Toc14635_WPSOffice_Level2

6、2.4. 錯誤碼一覽表8 HYPERLINK l _Toc11872_WPSOffice_Level1 3. API接口9 HYPERLINK l _Toc11960_WPSOffice_Level2 3.1. 實名分賬平臺提供的字典服務9 HYPERLINK l _Toc18201_WPSOffice_Level3 3.1.1. 調(diào)用API列表9 HYPERLINK l _Toc5166_WPSOffice_Level3 3.1.2. 人員類型數(shù)據(jù)字典 /CWRService/DictListEmpCategory9 HYPERLINK l _Toc28240_WPSOffice_Level

7、3 3.1.3. 獲取工種/崗位數(shù)據(jù)字典 /CWRService/DictListJobTypeName11 HYPERLINK l _Toc25849_WPSOffice_Level3 3.1.4. 獲取工種名稱數(shù)據(jù)字典 /CWRService/DictListJobName12 HYPERLINK l _Toc22083_WPSOffice_Level3 3.1.5. 獲取單位（公司）類型數(shù)據(jù)字典 /CWRService/GetCompanyType13 HYPERLINK l _Toc28918_WPSOffice_Level2 3.2. 實名分賬平臺提供的服務15 HYPERLINK

8、l _Toc5445_WPSOffice_Level3 3.2.1. 調(diào)用API列表15 HYPERLINK l _Toc10124_WPSOffice_Level3 3.2.2. 上報人員實名制信息 /CWRService/RegisterEmployee15 HYPERLINK l _Toc11011_WPSOffice_Level3 3.2.3. 上傳考勤信息 /CWRService/UploadPassedLog18 HYPERLINK l _Toc14635_WPSOffice_Level3 3.2.4. 人員離場 /CWRService/userLeaveProject19 HYP

9、ERLINK l _Toc11960_WPSOffice_Level3 3.2.5. 添加企業(yè)信息 /CWRService/AddCompany21 HYPERLINK l _Toc28918_WPSOffice_Level3 3.2.6. 項目下移除企業(yè)信息 /CWRService/ProjectRemoveCompany22 HYPERLINK l _Toc4395_WPSOffice_Level1 4. 聯(lián)調(diào)流程24 HYPERLINK l _Toc1239_WPSOffice_Level1 5. 技術(shù)支持24集成總體業(yè)務流程深圳市建筑業(yè)實名制與分賬制管理平臺（以下簡稱“實名分賬平臺”）

10、是深圳全市推行實名制管理和分帳制管理的總體信息平臺，各參建單位自建系統(tǒng)通過與實名分賬平臺集成，獲得工種、人員類別等數(shù)據(jù)字典信息；同時將自建系統(tǒng)中的項目、工程、單位信息，人員實名制信息、考勤信息、安全教育培訓記錄、工資發(fā)放記錄上報到實名分賬平臺。圖 SEQ 圖 * ARABIC 1實名分賬平臺與第三方系統(tǒng)集成關系注冊工程信息各建設項目的管理人員將項目工程信息信息在實名分賬平臺中進行注冊。項目管理人員提交項目工程申請表到實名分賬平臺“賬號注冊”，并在帳號申請通過后，登錄系統(tǒng)創(chuàng)建參建單位。項目工程信息注冊申請表見平臺“賬號注冊”頁面當中的附表下載。完善單位信息各項目上的管理人員登錄實名分賬平臺添加參

11、建單位到項目下。獲取工種、人員類別等數(shù)據(jù)字典信息第三方實名制系統(tǒng)通過集成接口獲得工種、人員類別等數(shù)據(jù)字典信息，用于上報人員實名制信息。上報人員實名制信息第三方實名制系統(tǒng)通過集成接口將本系統(tǒng)中的人員實名制信息上報到實名分賬平臺中。上報的實名制信息包括：項目編號、身份證號碼、身份證照片、員工姓名、手機號、身份證地址、民族、通行時段、現(xiàn)場采集人臉照片、所屬單位、班組名稱、人員類別、人員類型、工種名稱、簽發(fā)機關、有效期限、開戶銀行、銀行賬戶等。上傳考勤信息第三方實名制系統(tǒng)通過集成接口將本系統(tǒng)中的考勤信息上報到實名分賬平臺中，采用實時上報的方式。上傳的考勤信息包括：項目編號、門禁設備號、人員身份證號、人

12、員姓名、通行方向、通行方式以及現(xiàn)場采集的人臉照片等。上傳安全教育培訓記錄已取消。上傳工資發(fā)放記錄已取消。人員離場第三方實名制系統(tǒng)通過集成接口將本系統(tǒng)中的人員離場信息上傳到實名分賬平臺中。離場信息包括：項目編號、離場人員身份證號等。API調(diào)用說明集成方式采用Http請求方式，REST風格進行集成接口的訪問。第三方系統(tǒng)按照接口規(guī)范拼裝一個正確的URL，通過HTTP請求到實名分賬平臺接口。調(diào)用原理示意圖如下。調(diào)用方式說明URL地址/yyyyService/APIfunction?api_key=x1&api_version=x2& client_serial =x3timestamp =x4&sig

13、nature=x5EncodingUTF-8MethodPOSTBodyJSON數(shù)據(jù)返回JSON數(shù)據(jù)調(diào)用參數(shù)調(diào)用API ，必須傳入系統(tǒng)參數(shù)和應用參數(shù)。系統(tǒng)參數(shù)api_keyStringY授權(quán)帳號api_versionStringYAPI協(xié)議版本，可選值:1.0client_serialStringY第三方系統(tǒng)編號，“PL”+32位uuidtimestampStringY時間戳，格式為yyyy-MM-dd hh:mm:ss，例如：2016-06-06 13:52:03。服務端允許客戶端請求時間誤差為6分鐘signatureStringY對API輸入?yún)?shù)進行MD5加密獲得應用參數(shù)應用參數(shù)放在bod

14、y數(shù)據(jù)區(qū)簽名signature使用系統(tǒng)默認MD5加密，因為各語言語法不一致，以下實例只體現(xiàn)邏輯。為便于說明，假設 api_key、api_secret值均為 test。body區(qū)的數(shù)據(jù)項對應的json key為”body”， value為整個body原始字符串。1）所有參數(shù)為： api_key=test api_version=1.0 client_serial=facedevice_0613 timestamp=2016-06-10 09:05:03 body=client_version:2）按照參數(shù)名稱升序排列： api_key=test api_version=1.0 body=cli

15、ent_version: client_serial=facedevice_0613 timestamp=2016-06-10 09:05:03 3）連接字符串 連接參數(shù)名與參數(shù)值,并在首尾加上api_secret，如下：testapi_keytestapi_version1.0bodyclient_version:client_serialfacedevice_0613timestamp2016-06-10 09:05:03test若無應用參數(shù)時body為如下：testapi_keytestapi_version1.0bodyclient_serialfacedevice_0613times

16、tamp2016-06-10 09:05:03test4）生成簽名： 32位大寫MD5值-XXXXXXXXXXXXXXXXXXXX5）拼裝HTTP請求 將所有參數(shù)值轉(zhuǎn)換為UTF-8編碼，然后拼裝，通過瀏覽器訪問該地址，即成功調(diào)用一次接口。注意事項所有的請求和響應數(shù)據(jù)編碼皆為utf-8格式，url里的所有參數(shù)值請做urlencode編碼。錯誤碼一覽表coderesultmessage說明或解決方案00truesuccess（接口調(diào)用成功）11falseerror(調(diào)用接口失敗，具體信息見detail_message或result_data)10partial error部分失敗具體的信息見res

17、ult_data99false請求數(shù)據(jù)異常請查看詳細錯誤信息26false禁止訪問接口該用戶沒有權(quán)限訪問，包括（1）根據(jù)API_KEY檢測賬號是否授權(quán)；（2）接收到的API_KEY與根據(jù)設備序號在后端查詢到的API_KEY不一致時報此錯誤40false缺少必要參數(shù)請檢查參數(shù)41false非法的參數(shù)請檢查參數(shù)格式47falseERROR:未找到數(shù)據(jù)根據(jù)參數(shù)沒有查詢到數(shù)據(jù)，請檢查參數(shù)值的正確性48false數(shù)據(jù)重復同一條數(shù)據(jù)重復發(fā)送API接口測試環(huán)境登陸地址：5:7013 測試接口地址： HYPERLINK 5:7040 5:7040 正式環(huán)境登陸地址： 正式接口地址： 實名分賬平臺提供的字典服務

18、調(diào)用API列表API接口名稱API描述/CWRService/DictListEmpCategory人員類型數(shù)據(jù)字典/CWRService/DictListJobTypeName人員類別數(shù)據(jù)字典/CWRService/DictListJobName工種名稱數(shù)據(jù)字典/CWRService/GetCompanyType單位類型數(shù)據(jù)字典人員類型數(shù)據(jù)字典 /CWRService/DictListEmpCategory應用場景 獲取人員類型信息，建筑工人、正式人員、勞務派遣人員或?qū)＜业?。與項目無關，推送整個數(shù)據(jù)字典（上報人員實名制信息接口1.0版本的人員類型參數(shù)使用的是人員類型名稱，1.1版本使用的是人

19、員類型編碼）。輸入?yún)?shù)名稱類型是否必須描述api_keyStringY授權(quán)帳號api_versionStringYAPI協(xié)議版本，可選值:1.0client_serialStringY第三方系統(tǒng)編號timestampStringY時間戳，格式為yyyy-MM-dd hh:mm:ss，例如：2016-06-06 13:52:03。服務端允許客戶端請求時間誤差為6分鐘signatureStringY對API輸入?yún)?shù)進行MD5加密獲得POST的JSON數(shù)據(jù)名稱類型是否必須描述無請求url示例5:7040/CWRService/DictListEmpCategory?api_version=1.0&t

20、imestamp=2017-05-16 18:10:22&client_serial=PL2C9528C3C8D84206AC5B324DBE9DF92C&signature=D8F8149A7FC6533D848E3BF9F1E29347&api_key=DCD851F41C384EB3AE9326AD26EC667D返回的JSON數(shù)據(jù)名稱類型是否必須描述resultStringY接口調(diào)用結(jié)果。true表示接口調(diào)用成功，false表示接口調(diào)用失敗。statusIntegerYhttp協(xié)議狀態(tài)值codeStringY應用程序錯誤碼，詳見錯誤碼一覽表messageStringN錯誤信息detai

21、l_messageStringN詳細錯誤信息result_dataObjectY返回結(jié)果集成功返回的result_data結(jié)果集名稱類型是否必須描述dict_listObject ArrayY字典列表（下方三個屬性為字典列表內(nèi)容）ordersStringY編碼valueStringY名稱flagStringY默認項標識?！癥”-默認項，”N”-非默認項失敗返回的result_data結(jié)果集名稱類型是否必須描述無返回示例示例名稱示例說明失敗1失敗2失敗3成功返回狀態(tài)碼狀態(tài)碼返回狀態(tài)碼描述解決方案獲取工種/崗位數(shù)據(jù)字典 /CWRService/DictListJobTypeName應用場景 獲取人

22、員類別信息，比如一般作業(yè)工種、特種作業(yè)工種等。與項目無關，推送整個數(shù)據(jù)字典（上報人員實名制信息接口1.0版本（1.0版本已刪除，請不要使用）的人員類別參數(shù)使用的是人員類別名稱，1.1版本使用的是人員類別編碼）。輸入?yún)?shù)名稱類型是否必須描述api_keyStringY授權(quán)帳號api_versionStringYAPI協(xié)議版本，可選值:1.1client_serialStringY第三方平臺序列號timestampStringY時間戳，格式為yyyy-MM-dd hh:mm:ss，例如：2016-06-06 13:52:03。服務端允許客戶端請求時間誤差為6分鐘signatureStringY對A

23、PI輸入?yún)?shù)進行MD5加密獲得POST的JSON數(shù)據(jù)名稱類型是否必須描述無請求url示例5:7040/CWRService/DictListJobTypeName?api_version=1.0×tamp=2017-05-16 18:13:08&client_serial=PL2C9528C3C8D84206AC5B324DBE9DF92C&signature=C9A8510420812F6340B53B415682F836&api_key=DCD851F41C384EB3AE9326AD26EC667D返回的JSON數(shù)據(jù)名稱類型是否必須描述resultStringY接口調(diào)用結(jié)果。t

24、rue表示接口調(diào)用成功，false表示接口調(diào)用失敗。statusIntegerYhttp協(xié)議狀態(tài)值codeStringY應用程序錯誤碼，詳見錯誤碼一覽表messageStringN錯誤信息detail_messageStringN詳細錯誤信息result_dataObjectY返回結(jié)果集成功返回的result_data結(jié)果集名稱類型是否必須描述dict_listObject ArrayY字典列表（下方三個屬性為字典列表內(nèi)容）ordersStringY編碼valueStringY名稱flagStringY默認項標識?！癥”-默認項，”N”-非默認項失敗返回的result_data結(jié)果集名稱類型是

25、否必須描述無返回示例示例名稱示例說明失敗1失敗2失敗3成功獲取工種名稱數(shù)據(jù)字典 /CWRService/DictListJobName應用場景 獲取所有工種信息，如木工、混凝土工、機械操作工，等通過驗證后獲得系統(tǒng)所有班組名稱及工種名稱對應的工種編碼（上報人員實名制信息接口1.0版本的工種參數(shù)使用的是工種名稱（已作廢），1.1版本使用的是工種編碼）。輸入?yún)?shù)名稱類型是否必須描述api_keyStringY授權(quán)帳號api_versionStringYAPI協(xié)議版本，可選值:1.1client_serialStringY第三方系統(tǒng)編號timestampStringY時間戳，格式為yyyy-MM-dd

26、 hh:mm:ss，例如：2016-06-06 13:52:03。signatureStringY對API輸入?yún)?shù)進行MD5加密獲得POST的JSON數(shù)據(jù)名稱類型是否必須描述無請求url示例5:7040/CWRService/DictListJobName?api_version=1.0×tamp=2017-05-16 18:14:14&client_serial=PL2C9528C3C8D84206AC5B324DBE9DF92C&signature=F467F7D16D16867264C511E3A643E4BC&api_key=DCD851F41C384EB3AE9326AD2

27、6EC667D返回的JSON數(shù)據(jù)名稱類型是否必須描述resultStringY接口調(diào)用結(jié)果。true表示接口調(diào)用成功，false表示接口調(diào)用失敗。statusIntegerYhttp協(xié)議狀態(tài)值codeStringY應用程序錯誤碼，詳見錯誤碼一覽表messageStringN錯誤信息detail_messageStringN詳細錯誤信息result_dataObjectY返回結(jié)果集成功返回的result_data結(jié)果集名稱類型是否必須描述dict_listObject ArrayY字典列表（下方三個屬性為字典列表內(nèi)容）ordersStringY編碼valueStringY名稱flagString

28、Y默認項標識?！癥”-默認項，”N”-非默認項失敗返回的result_data結(jié)果集名稱類型是否必須描述無返回示例示例名稱示例說明失敗1失敗2失敗3成功返回狀態(tài)碼狀態(tài)碼返回狀態(tài)碼描述解決方案獲取單位（公司）類型數(shù)據(jù)字典 /CWRService/GetCompanyType應用場景 獲取所有單位類型，如監(jiān)理單位、設計單位等，通過驗證后獲得系統(tǒng)所有班組名稱及工種名稱對應的工種編碼，保存單位信息時獲取的是單位類型的編碼值。輸入?yún)?shù)名稱類型是否必須描述api_keyStringY授權(quán)帳號api_versionStringYAPI協(xié)議版本，可選值:1.1client_serialStringY第三方系統(tǒng)

29、編號timestampStringY時間戳，格式為yyyy-MM-dd hh:mm:ss，例如：2016-06-06 13:52:03。signatureStringY對API輸入?yún)?shù)進行MD5加密獲得POST的JSON數(shù)據(jù)名稱類型是否必須描述無請求url示例5:7040/CWRService/GetCompanyType?api_version=1.0×tamp=2017-05-16 18:25:46&client_serial=PL2C9528C3C8D84206AC5B324DBE9DF92C&signature=36F8D3B2D5DF63C655ED0EE011082D5B

30、&api_key=DCD851F41C384EB3AE9326AD26EC667D返回的JSON數(shù)據(jù)名稱類型是否必須描述resultStringY接口調(diào)用結(jié)果。true表示接口調(diào)用成功，false表示接口調(diào)用失敗。statusIntegerYhttp協(xié)議狀態(tài)值codeStringY應用程序錯誤碼，詳見錯誤碼一覽表messageStringN錯誤信息detail_messageStringN詳細錯誤信息result_dataObjectY返回結(jié)果集成功返回的result_data結(jié)果集名稱類型是否必須描述dict_listObject ArrayY字典列表（下方三個屬性為字典列表內(nèi)容）order

31、sStringY編碼valueStringY名稱flagStringY默認項標識。“Y”-默認項，”N”-非默認項失敗返回的result_data結(jié)果集名稱類型是否必須描述無返回示例示例名稱示例說明失敗1失敗2失敗3成功返回狀態(tài)碼狀態(tài)碼返回狀態(tài)碼描述解決方案實名分賬平臺提供的服務調(diào)用API列表API接口名稱API描述/CWRService/RegisterEmployee上報人員實名制信息/CWRService/UploadPassedLog上傳考勤信息/CWRService/UploadSafetyEducation上傳安全教育記錄/CWRService/UploadPayroll上傳工資發(fā)

32、放記錄/CWRService/userLeaveProject人員離場 /CWRService/AddCompany添加單位信息/CWRService/ProjectRemoveCompany項目下移除單位上報人員實名制信息 /CWRService/RegisterEmployee應用場景 第三方系統(tǒng)將人員實名制信息上傳到實名分賬平臺，同一個身份證號碼第一次上傳為新增，第二次及以上上傳則更新之前的人員信息。輸入?yún)?shù)名稱類型是否必須描述api_keyStringY授權(quán)帳號api_versionStringYAPI協(xié)議版本，可選值:1.1client_serialStringY第三方系統(tǒng)編號tim

33、estampStringY時間戳，格式為yyyy-MM-dd hh:mm:ss，例如：2016-06-06 13:52:03。服務端允許客戶端請求時間誤差為6分鐘signatureStringY對API輸入?yún)?shù)進行MD5加密獲得POST的JSON數(shù)據(jù)名稱類型是否必須描述Project_IDStringY同步編號id_codeStringY身份證號碼id_photoStringY身份證相片，Base64編碼emp_nameStringY員工姓名emp_phoneStringY手機號emp_nativeplaceStringY身份證地址emp_nationStringY民族(如：漢、苗、土家、維吾

34、爾等)pass_periodStringY通行時段，格式y(tǒng)yyy-MM-dd:yyyy-MM-dd如“2017-05-02:2017-12-31”，結(jié)束日期不確定時可為“2017-05-02:”值通行時段開始日期小于等于上傳日期，結(jié)束日期大于等于開始日期match_flagStringY匹配標識。 Y人證匹配，N不匹配，3次采集比對都沒通過facephotoStringY工地現(xiàn)場采集的人臉照片，Base64編碼emp_companyStringY所屬單位（填寫單位的全稱，以實名制系統(tǒng)錄入的為準）。emp_categoryStringY人員類型，參考人員類型字典3.1.3。1.0版本取消，不再支

35、持；1.1版本取字典對應的編碼（orders） (00: 勞務工人,01: 建設單位管理人員,02: 監(jiān)理單位管理人員,03: 施工單位管理人員,05: 其它參建單位管理人員) ，注意：人員類型上傳后不允許變更emp_deptStringN所屬部門(人員所在單位下的部門名稱)。job_typenameStringY工種/崗位。工種/崗位字典3.1.4。1.0版取消，不再支持；1.1版本取字典對應的編碼（orders）（1：一般作業(yè)工種，2：特種作業(yè)工種，3：項目管理崗位，4：其它工種）job_nameStringY工種名稱，參考工種數(shù)據(jù)字典3.1.5。1.0版本過時，取消；1.1版本取班組字典

36、對應的編碼（orders）contract_statusStringY合同辦理。1是，0否。id_agencyStringY簽發(fā)機關。id_validdateStringY有效期限。按身份證上顯示格式。emp_banknameStringN開戶行emp_cardnumStringN銀行賬號job_deptStringN現(xiàn)工作部門。(人員所在單位下的部門名稱)。idphoto_scanStringY身份證掃描件正面，Base64編碼idphoto_scan2StringY身份證掃描件反面，Base64編碼請求url示例5:7040/CWRService/RegisterEmployee?api_

37、version=1.0×tamp=2017-03-07 10:19:29&client_serial=PL2C9528C3C8D84206AC5B324DBE9DF92C&signature=88FD1C1DDA91ACEB6ECC17255BCBDCBA&api_key=DCD851F41C384EB3AE9326AD26EC667DPOST的JSON數(shù)據(jù)示例Project_ID:1000001,id_code:3708021992110112,id_photo:/9j/4AAQSk,emp_name:張三,emp_phone:1888888888,emp_nativeplace:

38、陜西省石泉縣城關鎮(zhèn)東街片七組173號,emp_nation:漢,pass_period:2017-01-01:2018-01-01,match_flag:Y,facephoto:wxHvRXgZcqeKKOVCuz/9k=,emp_company:中車信息技術(shù)有限公司,work_typename:0,emp_category:1,cwr_iskeypsn:1,emp_dept:技術(shù)部1,job_typename:00,job_name:EEF22645FEE411E68E5A089E016627F6,contract_status:1,id_agency:陜西省石泉縣城關鎮(zhèn)東街片七組173號,

39、id_validdate:2008.02.14-2028.02.14,emp_native_province:陜西,emp_bankname:建設銀行,emp_cardnum:6217002710000684874,job_dept:技術(shù)部,idphoto_scan:JAHGJ123,idphoto_scan2:JAHGJ1JKK/1223返回的JSON數(shù)據(jù)名稱類型是否必須描述resultStringY接口調(diào)用結(jié)果。true表示接口調(diào)用成功，false表示接口調(diào)用失敗。statusIntegerYhttp協(xié)議狀態(tài)值codeStringY應用程序錯誤碼，詳見錯誤碼一覽表messageString

40、N錯誤信息detail_messageStringN詳細錯誤信息result_dataObjectY返回結(jié)果集成功返回的result_data結(jié)果集名稱類型是否必須長度描述emp_idStringY32員工工號pass_periodStringY32通行時段，格式y(tǒng)yyy-MM-dd:yyyy-MM-ddmodify_timeStringY32修改時間,”yyyy-MM-dd hh:mm:ss.zzz”失敗返回的result_data結(jié)果集名稱類型是否必須描述無返回示例示例名稱示例說明失敗1失敗2失敗3成功返回狀態(tài)碼狀態(tài)碼返回狀態(tài)碼描述解決方案上傳考勤信息 /CWRService/Upload

41、PassedLog應用場景 第三方系統(tǒng)向?qū)嵜仲~平臺發(fā)送通行日志。按照住建局實名制規(guī)定實時上傳考勤數(shù)據(jù)，實時誤差范圍(上傳時間減去考勤通過時間)以住建局通知為準，目前誤差范圍為2 小時。工程狀態(tài)非“在建”，不允許上傳。輸入?yún)?shù)名稱類型是否必須描述api_keyStringY授權(quán)帳號api_versionStringYAPI協(xié)議版本，可選值:1.0client_serialStringY第三方系統(tǒng)編號timestampStringY時間戳，格式為yyyy-MM-dd hh:mm:ss，例如：2016-06-06 13:52:03。服務端允許客戶端請求時間誤差為6分鐘signatureString

42、Y對API輸入?yún)?shù)進行MD5加密獲得POST的JSON數(shù)據(jù)： 名稱類型是否必須描述Project_IDStringY同步編號Device_IDStringY門禁設備序列號passedlog_listObject ArrayY通行日志數(shù)組(下方所有屬性為通行日志數(shù)組內(nèi)容)person_typeStringY人員類型。0臨時人員（訪客），1員工person_idStringY人員編號（上報人員實名制信息接口返回的員工編號）或身份證號person_nameStringY人員姓名passed_timeStringY通過時間 ”yyyy-MM-dd hh:mm:ss”directionStringY通行

43、方向 in進，out出wayStringY通行方式 1人臉識別，2虹膜識別，3指紋識別site_photoStringN工地人臉照片數(shù)據(jù)，Base64編碼，圖像底部帶過閘時間水印，黑底白字longitudeStringN經(jīng)度latitudeStringN緯度addressStringN位置（打考勤時所在的詳細地址）無請求url示例5:7040/CWRService/UploadPassedLog?api_version=1.0×tamp=2017-03-07 10:21:32&client_serial=PL2C9528C3C8D84206AC5B324DBE9DF92C&signa

44、ture=B6876A3560308EE8D3CF2B4469AA0C09&api_key=DCD851F41C384EB3AE9326AD26EC667DPOST的JSON數(shù)據(jù)示例Project_ID:440300201500303,Device_ID:1,passedlog_list:person_type:1,person_id:1,person_name:fh,passed_time:2017-03-29 12:12:12,direction:in,way:1,site_photo:xVmxVbXVVaGN2emswdUJiT0QxU1dienArNFozVi9URn,person_t

45、ype:1,person_id:1,person_name:fh,passed_time:2017-03-29 16:12:12,direction:out,way:1,site_photo:xVmxVbXVVaGN2emswdUJiT0QxU1dienArNFozVi9URn返回的JSON數(shù)據(jù)名稱類型是否必須描述resultStringY接口調(diào)用結(jié)果。true表示接口調(diào)用成功，false表示接口調(diào)用失敗。statusIntegerYhttp協(xié)議狀態(tài)值codeStringY應用程序錯誤碼，詳見錯誤碼一覽表messageStringN錯誤信息detail_messageStringN詳細錯誤信息

46、result_dataObjectY返回結(jié)果集成功返回的result_data結(jié)果集名稱類型是否必須描述無失敗返回的result_data結(jié)果集名稱類型是否必須描述無返回示例示例名稱示例說明失敗1失敗2失敗3成功返回狀態(tài)碼狀態(tài)碼返回狀態(tài)碼描述解決方案人員離場 /CWRService/userLeaveProject應用場景 第三方人員離場時需要同步修改實名制平臺對應的人員狀態(tài)。輸入?yún)?shù)名稱類型是否必須描述api_keyStringY授權(quán)帳號api_versionStringYAPI協(xié)議版本，可選值:1.0client_serialStringY第三方系統(tǒng)編號timestampStringY時間

47、戳，格式為yyyy-MM-dd hh:mm:ss，例如：2016-06-06 13:52:03。服務端允許客戶端請求時間誤差為6分鐘signatureStringY對API輸入?yún)?shù)進行MD5加密獲得POST的JSON數(shù)據(jù)名稱類型是否必須描述Project_IDStringY同步編號userLeaveProject_listObject ArrayY用戶離場數(shù)組(下方所有屬性為人員數(shù)組內(nèi)容)id_codeStringY身份證號碼請求url示例5:7040/CWRService/ userLeaveProject?api_version=1.0×tamp=2017-03-07 10:19

48、:29&client_serial=PL2C9528C3C8D84206AC5B324DBE9DF92C&signature=88FD1C1DDA91ACEB6ECC17255BCBDCBA&api_key=DCD851F41C384EB3AE9326AD26EC667DPOST的JSON數(shù)據(jù)示例Project_ID:440300201500303, userLeaveProject_list :id_codeid_code回的JSON數(shù)據(jù)名稱類型是否必須描述resultStringY接口調(diào)用結(jié)果。true表示接口

49、調(diào)用成功，false表示接口調(diào)用失敗。statusIntegerYhttp協(xié)議狀態(tài)值codeStringY應用程序錯誤碼，詳見錯誤碼一覽表messageStringN錯誤信息detail_messageStringN詳細錯誤信息result_dataObjectY返回結(jié)果集成功返回的result_data結(jié)果集名稱類型是否必須長度描述無失敗返回的result_data結(jié)果集名稱類型是否必須描述無返回示例示例名稱示例說明失敗1失敗2失敗3成功返回狀態(tài)碼狀態(tài)碼返回狀態(tài)碼描述解決方案添加企業(yè)信息 /CWRService/AddCompany說明：如果添加企業(yè)的數(shù)據(jù)有誤，可以直接修改數(shù)據(jù)重新上傳，系統(tǒng)

50、會更新數(shù)據(jù)，即新增和修改接口一致。應用場景 用于在項目下注冊企業(yè)信息輸入?yún)?shù)名稱類型是否必須描述api_keyStringY授權(quán)帳號api_versionStringYAPI協(xié)議版本，可選值:1.0client_serialStringY第三方系統(tǒng)編號timestampStringY時間戳，格式為yyyy-MM-dd hh:mm:ss，例如：2016-06-06 13:52:03。服務端允許客戶端請求時間誤差為6分鐘signatureStringY對API輸入?yún)?shù)進行MD5加密獲得POST的JSON數(shù)據(jù)名稱類型是否必須描述Project_IDStringY同步編號Company_NameStringY企業(yè)名稱Short_NameStringN企業(yè)簡稱CapitalStringN注冊資金(單位:萬元)Legal_PersonStringY法定代表人SUIDStringY社會統(tǒng)一信用代碼（組織機構(gòu)代碼）Bank_OpenStringN基本賬戶開戶銀行Bank_NumStringN基本賬戶銀行賬號AddressStringN單位詳細地址ContactsStringN單位聯(lián)系人