1、 廣州市建設領域管理應用信息平臺建筑工人實名制數據接口標準目錄一、引言11.1編寫目的11.2適用范圍11.3簡稱和術語1二、開發規范22.1通信協議22.2通信安全22.3注意事項2三、接口說明43.1新增班組43.2修改班組53.3添加班組工人63.4修改班組工人83.5班組工人進退場9四、附錄104.1 測試環境104.2 結果碼對照表104.3 工種代碼表104.4 銀行代碼表112一、引言1.1編寫目的為實現廣州市建設領域管理應用信息平臺對項目從業人員實名制管理，考慮到部分項目已經在使用一些商業化實名制管理系統，為避免數據重復登記、減少系統改造成本，特編寫本接口文檔以供施工企業相關技

2、術人員對接。1.2適用范圍本文檔的適用對象為接入廣州市建設領域管理應用信息平臺的施工企業技術開發人員、日常維護人員。1.3簡稱和術語廣州市建設領域管理應用信息平臺：以下簡稱“信息平臺”施工企業：指依法取得施工企業資質證書，在本市從事建設施工活動的施工總承包企業、專業承包企業和勞務分包企業二、開發規范2.1通信協議l 采用HTTP（或HTTPS）協議進行請求和響應的處理。接口請求采用GET/POST方式。接口響應返回JSON格式的數據。l 由“信息平臺”提供接口地址，企業實名制或考勤系統。l 接口請求URL地址：詳見接口說明。l 接口未注明處均使用UTF-8編碼。l 通信過程中涉及的中文或特殊符

3、號的傳輸，需進行urlencode處理。l HTTP（或HTTPS）請求參數均為字符串。l 接口請求需進行簽名，詳見2.2通信安全一節。2.2通信安全為保證數據傳輸過程中的數據真實性，我們需要對數據進行數字簽名，在接收簽名數據之后進行簽名校驗。“信息平臺”會為施工企業的每個工程分配唯一的接入編號和接入密鑰。簽名機制如下：l 對全部有長度限制的傳輸字段（不包括NL類型的字段）進行簽名，將參數名（區分大小寫）和參數值（需進行urlencode處理）用“=”連接，參數值為空的參數不參與簽名，參數之間用“&”連接，格式是：param1=val1&param2=val2。l 參數組裝順序

4、規則：參數名的字典順序。l 密鑰拼接方式為傳輸參數直接連接密鑰，如只有param1和param2兩參數，值分別為val1和val2，密鑰為key，拼接結果為：param1=val1&param2=val2key。l 使用“信息平臺”分配的密鑰進行MD5加密（密鑰直接跟在組裝好的參數后即可），將值賦給sign參數。l 敏感信息班組編號、身份證圖片路徑、身份證號、銀行卡號、社保號需要加密傳輸，使用DES加密，加密key等于接入密鑰，加密后的字節碼轉為16進制編碼的字符串，并在密文字符串的前面加“des:”前綴。算法：密文=”des:” + HEX(DES(idcard, key)，如：身份

5、證號：5113011990010181111，接入密鑰：8c2da4c769828fcfa77aedb690999cf9，密文：des:80cfe03525bb2b8d43d62ff369e95334cd1facfe4bbb800c2.3注意事項l 接口中各項參數當標識是M時參數必選，為O時可選。l 接口字段長度分為三種：無限制（NL），固定長度（FL），可變長度（VL）。如果為FL，則長度必須精確到FL后跟隨的數字，格式舉例FL14；如果為VL，則長度在可變范圍內即可，如果長度不夠，不補空格或其它字符，格式舉例VL30。l 接口說明中，若參數字體為紅色，請仔細閱讀備注說明。l 請求返回結果碼

6、不為0時，需要再次提交請求。如果結果碼大于0，則需要根據提示信息修改錯誤后再次提交；如果結果碼小于0，可以間隔一段時間再提交（如：選擇間隔5分鐘、10分鐘、30分鐘、1小時提交一次，連續5次提交不成功時推遲到第二天再提交）。三、接口說明l 所有接口響應的返回信息均以JSON字符串形式返回，可以使用JSON工具包對其進行解析。l 返回信息具體字段參照接口說明中的響應參數，以下以舉例：處理成功："resultCode":0,"resultDesc":"處理成功"處理失敗："resultCode":1,"res

7、ultDesc":"簽名錯誤"l 返回結果碼對照見附錄4.2結果碼對照表。3.1新增班組接口說明接口描述施工企業添加班組時調用請求地址/smz/team/save測試請求地址請求參數參數限制長度注釋備注accessNoMFL32接入編號“信息平臺”為施工企業分配的接入編號teamCodeMVL320班組編碼工程內部的班組唯一編碼，如果班組編碼已存在則修改班組。格式：班組長身份證號 + 班組類型代碼，使用DES加密nameMVL40班組名稱班組命名格式：班組長姓名 + 班組類型 + “班組”workTypeMVL32班組類型參考附錄4.3leaderAppointm

8、entOVL400班組長證明書外網能訪問的URL路徑，“信息平臺”會自動抓取leaderIdcardMVL150工人身份證號檢查工人是否存在的依據，使用DES加密leaderNameMVL30工人姓名leaderSexMFL1性別M：男 F：女leaderNationMVL40民族leaderBirthdayMFL8生日yyyyMMddleaderAddressMVL400住址身份證上的住址leaderSignOrganMVL30簽發機關身份證的簽發機關leaderExpiryStartMFL8有效期開始日期身份證有效期開始日期leaderExpiryEndOFL8有效期結束日期身份證有效期結

9、束日期，為空表示長期leaderHeadImgOVL400身份證頭像URL外網能訪問的URL路徑，“信息平臺”會自動抓取leaderIdcardFrontOVL1500身份證正面照外網能訪問的URL路徑，“信息平臺”會自動抓取，使用DES加密leaderIdcardBackOVL1500身份證反面照外網能訪問的URL路徑，“信息平臺”會自動抓取，使用DES加密leaderCurrentAddressMVL400常住地址近期的常住地址leaderPoliticalMFL1政治面貌0：黨員 1：團員 2：群眾leaderEducationMVL32文化程度本科以上、本科、大專、中專、高中、初中及以

10、下leaderPhoneMVL11手機號leaderEmployTypeMFL1用工形式0：固定工人 1：外聘leaderTechLevelMFL1技能水平0：無(普通)；1：初級工；2：中級工；3：高級工；4：技師；5：高級技師leaderContractCodeOVL50合同編號施工企業內部的合同編號。leaderContractFileOVL400合同附件外網能訪問的URL路徑，“信息平臺”會自動抓取。leaderCardNumOVL150工資卡賬號使用DES加密leaderCardBankOVL10工資卡開戶行代碼參考附錄4.4leaderWorkTypeMVL32工種代碼參考附錄4.

11、3leaderSecurityCodeOVL300社保號使用DES加密leaderSafetyEduMFL1是否參加安全教育true: 是；false：否leaderSafetyEduImgOVL400安全教育圖片外網能訪問的URL路徑，“信息平臺”會自動抓取。leaderBuilderTypeMFL1工人類型0：建筑工匠；1：建筑產業技術工人；2：其他leaderDoDateMFL8進場日期yyyyMMddtimestampMFL17時間戳北京時間精確到毫秒(yyyyMMddHHmmssSSS)signMFL32簽名響應參數參數限制說明resultCodeM返回結果碼，數字類型。0表示成功；

12、其它表示失敗。resultDescO返回結果描述3.2修改班組接口說明接口描述施工企業修改班組時調用請求地址/smz/team/update測試請求地址請求參數參數限制長度注釋備注accessNoMFL32接入編號“信息平臺”為施工企業分配的接入編號teamCodeMVL320班組編碼工程內部的班組唯一編碼，如果班組編碼已存在則修改班組。格式：班組長身份證號 + 班組類型代碼，使用DES加密nameMVL40班組名稱班組命名格式：班組長姓名 + 班組類型 + “班組”workTypeMVL32班組類型參考附錄4.3leaderAppointmentOVL400班組長證明書外網能訪問的URL路徑

13、，“信息平臺”會自動抓取leaderIdcardMVL150工人身份證號檢查工人是否存在的依據，使用DES加密leaderCurrentAddressMVL400常住地址近期的常住地址leaderPoliticalMFL1政治面貌0：黨員 1：團員 2：群眾leaderEducationMVL32文化程度本科以上、本科、大專、中專、高中、初中及以下leaderPhoneMVL11手機號leaderEmployTypeMFL1用工形式0：固定工人 1：外聘leaderTechLevelMFL1技能水平0：無(普通)；1：初級工；2：中級工；3：高級工；4：技師；5：高級技師leaderContr

14、actCodeOVL50合同編號施工企業內部的合同編號。leaderContractFileOVL400合同附件外網能訪問的URL路徑，“信息平臺”會自動抓取。leaderCardNumOVL150工資卡賬號使用DES加密leaderCardBankOVL10工資卡開戶行代碼參考附錄4.4leaderWorkTypeMVL32工種代碼參考附錄4.3leaderSecurityCodeOVL300社保號使用DES加密leaderSafetyEduMFL1是否參加安全教育true: 是；false：否leaderSafetyEduImgOVL400安全教育圖片外網能訪問的URL路徑，“信息平臺”會

15、自動抓取。leaderBuilderTypeMFL1工人類型0：建筑工匠；1：建筑產業技術工人；2：其他timestampMFL17時間戳北京時間精確到毫秒(yyyyMMddHHmmssSSS)signMFL32簽名響應參數參數限制說明resultCodeM返回結果碼，數字類型。0表示成功；其它表示失敗。resultDescO返回結果描述3.3添加班組工人接口說明接口描述為已登記的班組添加工人。請求地址/smz/teamBuilder/save測試請求地址請求參數參數限制長度注釋備注accessNoMFL32接入編號“信息平臺”為施工企業分配的接入編號teamCodeMVL320班組編碼工程內

16、部的班組唯一編碼，如果班組編碼已存在則修改班組，使用DES加密idcardMVL150工人身份證號檢查工人是否存在的依據，如果工人已存在則修改，使用DES加密nameMVL30工人姓名sexMFL1性別M：男 F：女nationMVL40民族birthdayMFL8生日yyyyMMddaddressMVL400住址身份證上的住址signOrganMVL30簽發機關身份證的簽發機關expiryStartMFL8有效期開始日期身份證有效期開始日期expiryEndOFL8有效期結束日期身份證有效期結束日期，為空表示長期headImgOVL400身份證頭像URL外網能訪問的URL路徑，“信息平臺”會

17、自動抓取idcardFrontOVL1500身份證正面照外網能訪問的URL路徑，“信息平臺”會自動抓取，使用DES加密idcardBackOVL1500身份證反面照外網能訪問的URL路徑，“信息平臺”會自動抓取，使用DES加密currentAddressMVL400常住地址近期的常住地址politicalMFL1政治面貌0：黨員 1：團員 2：群眾educationMVL20文化程度本科以上、本科、大專、中專、高中、初中及以下phoneMVL11手機號employTypeMFL1用工類型0：自有工人；1：外聘工人contractCodeOVL50合同編號施工企業內部的合同編號。contract

18、FileOVL400合同附件外網能訪問的URL路徑，“信息平臺”會自動抓取。cardNumOVL150工資卡賬號使用DES加密cardBankOVL10工資卡開戶行代碼參考附錄4.4workTypeMVL32工種代碼參考附錄4.3techLevelMFL1技能水平0：無(普通)；1：初級工；2：中級工；3：高級工；4：技師；5：高級技師securityCodeOVL300社保號使用DES加密safetyEduMFL1是否參加安全教育true: 是；false：否safetyEduImgOVL400安全教育圖片外網能訪問的URL路徑，“信息平臺”會自動抓取。builderTypeMFL1工人類型

19、0：建筑工匠；1：建筑產業技術工人；2：其他doDateMFL8進場日期yyyyMMddtimestampMFL17時間戳北京時間精確到毫秒(yyyyMMddHHmmssSSS)signMFL32簽名響應參數參數限制說明resultCodeM返回結果碼，數字類型。0表示成功；其它表示失敗。resultDescO返回結果描述3.4修改班組工人接口說明接口描述修改已登記的班組工人。請求地址/smz/teamBuilder/update測試請求地址請求參數參數限制長度注釋備注accessNoMFL32接入編號“信息平臺”為施工企業分配的接入編號teamCodeMVL320班組編碼工程內部的班組唯一編

20、碼，如果班組編碼已存在則修改班組，使用DES加密idcardMVL150工人身份證號檢查工人是否存在的依據，如果工人已存在則修改，使用DES加密currentAddressMVL400常住地址近期的常住地址politicalMFL1政治面貌0：黨員 1：團員 2：群眾educationMVL20文化程度本科以上、本科、大專、中專、高中、初中及以下phoneMVL11手機號employTypeMFL1用工類型0：自有工人；1：外聘工人contractCodeOVL50合同編號施工企業內部的合同編號。contractFileOVL400合同附件外網能訪問的URL路徑，“信息平臺”會自動抓取。car

21、dNumOVL150工資卡賬號使用DES加密cardBankOVL10工資卡開戶行代碼參考附錄4.4workTypeMVL32工種代碼參考附錄4.3techLevelMFL1技能水平0：無(普通)；1：初級工；2：中級工；3：高級工；4：技師；5：高級技師securityCodeOVL300社保號使用DES加密safetyEduMFL1是否參加安全教育true: 是；false：否safetyEduImgOVL400安全教育圖片外網能訪問的URL路徑，“信息平臺”會自動抓取。builderTypeMFL1工人類型0：建筑工匠；1：建筑產業技術工人；2：其他timestampMFL17時間戳北京

22、時間精確到毫秒(yyyyMMddHHmmssSSS)signMFL32簽名響應參數參數限制說明resultCodeM返回結果碼，數字類型。0表示成功；其它表示失敗。resultDescO返回結果描述3.5班組工人進退場接口說明接口描述班組工人進場或退場。請求地址/smz/enterExit/save測試請求地址請求參數參數限制長度注釋備注accessNoMFL32接入編號“信息平臺”為施工企業項目分配的接入編號teamCodeMVL320班組編碼工程內部的班組唯一編碼，如果班組編碼已存在則修改班組，使用DES加密idcardMVL150工人身份證號檢查工人是否存在的依據，使用DES加密typeMFL1類型0：進場；1：退場doDateMFL8進退場日期yyyyMMddtimestampMFL17時間戳北京時間精確到毫秒(yyyyMMddHHmmssSSS)signMFL32簽名響應參數參數限制說明resultCodeM返回結果碼，數字類型。0表示成功；其它表示失敗。resultDescO返回結果