四川建筑工人管理服务信息平台_第1页
四川建筑工人管理服务信息平台_第2页
四川建筑工人管理服务信息平台_第3页
四川建筑工人管理服务信息平台_第4页
四川建筑工人管理服务信息平台_第5页
免费预览已结束,剩余35页可下载查看

下载本文档

版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领

文档简介

1、四川省建筑工人管理服务信息平台数据共享交换接口标准(试行)四川省住房和城乡建设厅2018 年 9 月目录1 接口说明 1.1实名核验接口1.2数据上报接口2 接口方式 2.1REST风格 2.2公共参数 2.2.1 请求公共参数 2.2.2 返回公共参数 2.2.3 错误信息结构 2.3 访问控制 2.4 数据加密 3 接口流程 4 接口 API 4.1 安全会话接口 4.1.1 security/login4.1.2 security/logout 4.2 实名制验证接口 Verification/enterprise Verification/personnel Verification/

2、project Verification/getProjectCode . Verification/getDeviceCode . Verification/getProjectPayCode 实名制数据上报接口 Post/enterprise Post/personnel Post/project Post/projectAttend Post/projectEntryExit Post/projectPay Post/projectMechanics Post/projectAppraise Post/retUpInfo .223.46..41.2.4

3、.....95 接口内容.35.4.4企业实名核验 建筑工人实名核验 项目信息申报核验 项目数据上报 项目信息上报 考勤信息上报 进退场信息上报 工资信息上报 .....1.0.6...... ..5.4.6 工人评价上报...

4、..45.5 企业数据上报5.6 人员数据上报 接口验证 6.1 实名核验规则6.1.1 企业实名核验规则 .6.1.2 建筑工人实名核验规则6.1.3 项目信息核验规则 .6.2 信息上报验证规则 6.2.1 项目数据上报验证规则6.2.2 企业数据上报验证规则6.2.3 人员数据上报验证规则1 接口说明四川省建筑工人管理服务信息平台提供 “实名核验接口”、“数据 上报接口”两大类开放式服务接口。1.1 实名核验接口1) 企业实名核验接口:通过接口 API 提交企业实名认证资料, 省级建筑工人管理服务信息平台对企业基础信息进行校验, 通过后返回企业实名核验码;2) 建筑工人实名

5、核验接口:通过接口 API 建筑工人实名认证资 料,省级建筑工人管理服务信息平台对建筑工人身份进行校 验,通过后返回建筑工人实名核验码;3) 项目信息申报核验接口:通过接口 API 申请项目编码,提交 项目基本资料,省级建筑工人管理服务信息平台对项目基本 信息进行校验,通过后返回项目核验码。1.2 数据上报接口1) 项目数据上报接口:通过项目信息上报、考勤信息上报、进 退场信息上报、工资信息上报、现场机械上报、工人评价上 报等六个接口 API 分别上报项目信息、参建单位信息、项目 班组信息、管理人员信息、工人培训信息、考勤记录信息、 工人及班组进退场记录、 工人工资信息、 施工现场机械信息、

6、建筑工人诚信评价信息等数据,省级建筑工人管理服务信息 平台进行数据更新和存储;2) 企业数据上报接口:通过接口 API 上报企业基本信息、企业资质证书信息、企业资质信息等数据,省级建筑工人管理服 务信息平台进行数据更新和存储;3)人员数据上报接口:通过接口 API 上报人员实名信息、人员 证书信息等数据,省级建筑工人管理服务信息平台进行数据 更新和存储。2 接口方式2.1 REST风格建筑工人实名制数据接口 API 按照 REST风格设计,通过 HTTP协 议的 GET方法或 POST方法提交请求。使用 GET方法,请求参数通过 URL查询参数(QueryParam)提供。使用 POST方法,

7、请求公共参数通过 URL查询参数(QueryParam) 提供,接口专用参数通过请求正文 ( Body)、按照 JSON格式封装提供。2.2 公共参数建筑工人实名制数据接口 API 的请求和返回均包含规定的公共 参数,如无特殊说明, 所有接口方法都包含以下请求公共参数以及返 回公共参数。2.2.1 请 求公共参数参数名必选类型范围说明access token是String访问令牌。成功调用 login 接口后返回sign否String请求参数签名值(预留)signCert否String签名证书序列号sign method否String签名方法(预留)timestamp否Date应用程序发出请求

8、的客户端时间。平台 在接收到请求后,会与当前服务端时间 比较,如果在误差范围大于 10 分钟,将 请求视为无效request_id否String应用程序发出请求的唯一标识号。平台 如果在误差时间内接收到多个 request_id 相同的请求,除最早收到的 一个请求外,其它请求将视为重放攻击 而被忽略2.2.2 返 回公共参数参数名必选类型范围说明ack_code是String接口调用是否成功SUCCES:S成功FAILURE:失败errors否List<Error>错误信息sign否String请求参数签名值(预留)sign method否String签名方法(预留)timesta

9、mp否Date接口响应的服务端时间correlation_i d否String对应的请求 request_id 。如果请求提供 了 request_id 参数,在响应时会原样返 回response id否String接口返回的唯一标识号2.2.3 错 误信息结构Error 类属性类型长度可空说明codeString10否错误代码messageString4000否错误信息描述inner codeString50是内部代码2.3 访问控制接入单位通过接口只允许上报指定行政区划范围内的数据, 每用 户并发请求数目必须小于 10r/s ,即用户 1s 内最多请求 10次,超过 则拒绝访问。2.4 数

10、据加密敏感信息(银行卡号,证件号码等)需要加密传输,请使用 AES 加密,算法说明 :算法密钥 =接入密钥 KEY,编码 =UTF-8,加密模式 (CipherMode)=CBC,填充模式 (PaddingMode)=PKCS7,数据块大小 (BlockSize)=128 ,算法的初始化向量 (IV)= 接入密钥 KEY的前 16 位字符。 加密后的字节数组转为 Base64 字符串,需要加密的字段会在字 段备注中添加 AES'标记。算法:密文 =Base64(AES(info, KEY) 。3 接口流程接口 API 调用流程分为三个步骤:第一步:调用 login 创建安全会话获取 a

11、ccess_token 调用安全会话接口的 login 方法,以创建会话获取访问令牌access_token 。 请求示例POST application/json"app_key":"APP_KEY","app_secret":"APP_SECRET","account":"ACCOUNT","password" :" PASSWORD"返回结果"ack_code":"SUCCESS",&quo

12、t;errors":,"access_token":"ACCESS_TOKEN","expires_in":"864 00"第二步:使用 access_token 调用接口 API把 access_token 作为请求的公共参数来调用建筑工人实名制接 口 API。请求示例GET"ack_code":"SUCCESS","errors":,"data":"account":"sc_wjl"

13、,"name":"xxxxx 用户 ","identity_num":"440102,"division":" 成都市 ","division_code":"510000xxx,"service_org":"9","creator":"admin","creation_time":"2018-5-22","last_modifi

14、cator":"admin","last_modification_time":"2020-5-22"第三步:调用 logout 注销会话调用安全会话接口的 logout 方法,设置 access_token 为无效。 请求示例POST application/json返回结果"ack_code":"SUCCESS","errors":4 接口 API4.1 安全会话接口4.1.1 security/login方法名称login方法说明通过用户名和密码进行身份验证,

15、 验证成功后创建一个会话。 所 有对数据和附件的管理操作都必须在有效的会话内进行, 因此创建会 话是接口系统调用的第一个方法。请求方法POSTURL地址是String分配给应用程序的 app keyapp secret是String分配给应用程序的 app secretaccount是String用户账户名称password是String用户账户密码org code否String管理员身份登录返回结果参数名必选类型范围说明access token是String登录成功则返回安全会话访问令牌expires_in是Integer访问令牌超时时间 (以秒为单位),缺省 24 小 时请求示例POSTC

16、ontent-Type: application/json"app_key":"APP_KEY", "app_secret":"APP_SECRET", "account":"test_gd_jkc", "password":"abc123"返回示例"ack_code":"SUCCESS","errors":,"access_token":"ACC

17、ESS_TOKEN","expires_in":"86400"注意事项无4.1.2 security/logout方法名称logout方法说明注销当前会话。请求方法POSTURL地址Content-Type: application/json返回示例"ack_code":"SUCCESS","errors":注意事项无4.2 实名制验证接口4.2.1 Verification/enterprise方法名称enterprise方法说明提交验证企业实名制信息,返回取信息号码。 请求方法GE

18、TURL地址Verification/enterprise访问权限所有已登录用户。请求参数参数名必选类型范围说明CompanyName是String企业名称SocialCreditNumber是String社会统一信用代码RepresentativeName是String法定代表人姓名CellPhone是String法定代表人手机号Status是String企业经营状态返回结果"ack_code":"SUCCESS", "ID":" 取信息号码 ","errors":请求示例POSTConten

19、t-Type: application/json"CompanyName ":" 公司名 ", "SocialCreditNumber ":" 社会统一信用代码 ", "RepresentativeName":" 法定代表人姓名 ", "CellPhone":" 法定代表人电话号码 ", "Status":" 企业经营状态 "4.2.2 Verification/personnel方法名称pers

20、onnel方法说明提交验证人员实名制信息,返回取信息号码请求方法GETURL地址Verification/ personnel访问权限所有已登录用户。请求参数参数名必选类型范围说明参数名必选类型范围说明PersonName是String人员姓名Mobile是String手机号码IDCardType是String证件类型IDCardNumber是String证件号码( AES)CardFront是String身份证正面照片 Base64(传入 )CardBack是String身份证背面照片 Base64(传入 )PensonAndCard是String手持身份证照片 Base64(传入 )Pro

21、filePhoto是String默认头像 Base64(传入 )返回结果"ack_code":"SUCCESS", "ID":" 取信息号码 " ,"errors":请求示例POSTContent-Type: application/json" WorkerName ":" 人员姓名 ", " Mobile ":" 手机号码 ", " IDCardType":" 证件类型 ",

22、 " IDCardNumber":" 证件号码 ", " CardFront ":" 身份证正面照片 Base64编码 ", " CardBack ":"身份证背面照片 Base64(传入)", " PensonAndCard ":" 手持身份证照片 Base64(传入 )", " ProfilePhoto":" 默认头像 Base64(传入 )"4.2.3 Verification/projec

23、t方法名称personnel方法说明提交项目申报核验信息,返回取信息号码请求方法GETURL地址Verification/ project访问权限所有已登录用户请求参数参数名必选类型范围说明ProjectCode是String项目编码ProjectName是String项目名称ProjectCategory是String项目类别OwnerName是String建设单位名称BuildCorporationCode是String建设单位统一社会信用代码AreaCode是String项目所在地Address是String项目位置Invest是String项目投资额PrjSize是String项目规模

24、StartDate是String开工日期CompleteDate是String拟竣工日期PrjStatus是String项目状态返回结果"ack_code":"SUCCESS", "ID":" 取信息号码 ","errors":请求示例POST project?access_token=ACCESS_TOKEN Content-Type: application/json" ProjectCode ":" 项目编码 ", " ProjectNam

25、e ":" 项目名称 ", " ProjectCategory ":" 项目类别 ", " AreaCode ":" 项目所在地 ", .4.2.4 Verification/getProjectCode方法名称getProjectCode方法说明申请项目编码,返回项目编码。 请求方法GETURL地址Verification/getProjectCode访问权限所有已登录用户。请求参数无返回结果"ack_code":"SUCCESS","

26、; ProjectCode":" 项目编码 " ,"errors":请求示例POST Verification/getProjectCode?access_token=ACCESS_TOKEN4.2.5 Verification/getDeviceCode方法名称getDeviceCode方法说明申请人员信息采集设备编码,返回设备编码。请求方法GETURL地址Verification/ getDeviceCode访问权限所有已登录用户。请求参数参数名必选类型范围说明ProjectCode是String项目编码DeviceType是String类

27、型DeviceBrand是String设备品牌DeviceModel是String设备型号DeviceSN是String设备序号DeviceHardwareSN是String设备硬件唯一编号返回结果"ack_code":"SUCCESS","DeviceCode ":" 设备编码 " ,"errors":请求示例POST Verification/getDeviceCode?access_token=ACCESS_TOKENContent-Type: application/json"

28、 ProjectCode ":" 项目编码 ", " DeviceType ":" 类型 ", " DeviceBrand ":" 设备品牌 ", " DeviceModel ":" 设备型号 ", " DeviceSN ":" 设备序号 ", " DeviceHardwareSN ":" 设备硬件唯一编号 "4.2.6 Verification/getProject

29、PayCode方法名称getProjectPayCode方法说明申请工资单编码,返回工资单编码。请求方法GETURL地址"ack_code":"SUCCESS","ProjectPayCode":" 工资单编码 " ,"errors":请求示例POST ,获取实名制验证结果。请求方法GETURL地址Verification/ RetVeriInfo访问权限所有已登录用户请求参数参数名必选类型范围说明ID是String取信息号码VeriType是String验证类型:enterprise :企业实

30、名制验证 personnel :个人实名制验证 project :项目信息制验证返回结果"ack_code":"SUCCESS","datas":,"errors":请求示例POST RetVeriInfo?access_token=ACCESS_TOKENContent-Type: application/json" ID":" 项目编号 ", " VeriType ":" 验证类型 "4.3 实名制数据上报接口4.3.1 Post/

31、enterprise方法名称enterprise方法说明上报企业信息,返回取信息号码请求方法POSTURL地址post/enterprise访问权限所有已登录用户请求参数参见“ 企业数据上报”返回结果"ack_code":"SUCCESS", "ID":" 取信息号码 " ,"errors": 请求示例POST post/enterprise?access_token=ACCESS_TOKENContent-Type: application/json" 企业基本信息 ":,

32、 " 企业资质证书信息 ":, " 企业资质信息 ":,4.3.2 Post/personnel方法名称personnel方法说明上报人员信息,返回取信息号码请求方法POSTURL地址post / personnel访问权限所有已登录用户。请求参数参见“ 人员数据上报”。 返回结果"ack_code":"SUCCESS", "ID":" 取信息号码 " ,"errors":请求示例POST post/ personnel?access_token=ACCE

33、SS_TOKEN Content-Type: application/json, " 人员基本信息 ":, , " 人员证书信息 ":, 4.3.3 Post/project方法名称project方法说明上报项目信息,返回取信息号码。 请求方法POSTURL地址post / project访问权限所有已登录用户。请求参数参见“ 项目信息上报”。返回结果"ack_code":"SUCCESS", "ID":" 取信息号码 ","errors":请求示例POS

34、T post/ project?access_token=ACCESS_TOKENContent-Type: application/json" 项目信息 ":, ," 施工许可证 ":," 人员信息采集设备 ":, ," 参建单位信息 ":, " 项目班组基本信息 ":, " 建筑工人信息 ":, " 施工管理人员信息 ":, , " 监理从业人员信息 ":, , " 工人劳动合同信息 ":, , " 培

35、训基本信息 ":, , " 培训详情信息 ":, , " 企业银行卡信息 ":, , " 个人银行卡信息 ":, 4.3.4 Post/projectAttend方法名称projectAttend方法说明考勤信息上报,返回取信息号码。请求方法POSTURL地址post / projectAttend访问权限所有已登录用户。请求参数参见“ 考勤信息上报”。返回结果"ack_code":"SUCCESS", "ID":" 取信息号码 ","

36、errors":请求示例POST post/ projectAttend?access_token=ACCESS_TOKENContent-Type: application/json"考勤记录信息 ":, 4.3.5 Post/projectEntryExit方法名称projectEntryExit方法说明班组和工人进退场信息上报,返回取信息号码。请求方法POSTURL地址post / projectEntryExit访问权限所有已登录用户。请求参数参见“ 进退场信息上报”。返回结果"ack_code":"SUCCESS"

37、, "ID":" 取信息号码 ","errors":请求示例POST post/ projectEntryExit?access_token=ACCESS_TOKENContent-Type: application/json" 班组进退场记录信息 ":, ," 工人进退场记录信息 ":, 4.3.6 Post/projectPay方法名称projectPay方法说明上报工人工资信息,返回取信息号码。请求方法POSTURL地址post / projectPay访问权限所有已登录用户。请求参数参见

38、“ 工资信息上报”。返回结果"ack_code":"SUCCESS", "ID":" 取信息号码 ","errors":请求示例POST post/ projectPay?access_token=ACCESS_TOKEN Content-Type: application/json"工资单信息 ":, ," 工人工资信息 ":, 4.3.7 Post/projectMechanics方法名称projectMechanics方法说明上报现场机械设备信息,返

39、回取信息号码请求方法POSTURL地址post / projectMechanics访问权限所有已登录用户。请求参数参见“ 现场机械上报”返回结果"ack_code":"SUCCESS", "ID":" 取信息号码 ","errors":请求示例POST post/ projectMechanics?access_token=ACCESS_TOKENContent-Type: application/json" 施工现场机械设备基本信息 ":, ," 施工现场机械使

40、用信息 ":, ," 用油管理信息 ":, 4.3.8 Post/projectAppraise方法名称上报工人评价信息,返回取信息号码请求方法POSTURL地址访问权限所有已登录用户请求参数参见“ 工人评价上报”返回结果"ack_code":"SUCCESS" , "ID":" 取信息号码 ","errors":请求示例POST post/ projectAppraise?access_token=ACCESS_TOKENContent-Type: applica

41、tion/json" 工人奖励信息 ":, ," 工人不良行为信息 ":, , " 工人黑名单信息 ":, " 班组评价信息 ":, " 工人评价信息 ":,4.3.9 Post/retUpInfo方法名称RetUpInfo方法说明传入取信息号码,获取数据上报验证结果。 请求方法GETURL地址Verification/ retUpInfo访问权限所有已登录用户请求参数参数名必选类型范围说明ID是String取信息号码UpType是String上传类型:参数名必选类型范围说明enterprise

42、 :企业数据上报 personnel :个人数据上报 project :项目信息上报 projectAttend :考勤信息上报 projectEntryExit :进退场信息上报 projectPay :工资信息上报 projectMechanics :现场机械上报 projectAppraise :工人评价上报返回结果"ack_code":"SUCCESS","datas":,"errors":请求示例POST RetUpInfo?access_token=ACCESS_TOKENContent-Type: a

43、pplication/json" ID":" 项目编号 "," UpType ":" 上传类型 "5 接口内容5.1 企业实名核验企业实名核验接口 API 的请求参数包括企业名称、 统一社会信用 代码、法定代表人姓名、法定代表人手机号、经营状态等内容,具体 信息见四川省建筑工人实名制基础信息数据标准以下章节:企业实名认证信息5.2 建筑工人实名核验建筑工人实名核验接口 API 的请求参数包括姓名、 手机号码、 证 件类型、证件号码、身份证正面照片、身份证背面照片、手持身份证 照片、默认头像等内容,具体信息见四川省建

44、筑工人实名制基础信 息数据标准以下章节:人员实名认证信息5.3 项目信息申报核验项目信息核验接口 API 的请求参数包括项目编码、 项目名称、项 目类别、建设单位名称、建设单位统一社会信用代码、项目所在地、 项目位置、项目投资额、项目规模、开工日期、拟竣工日期、项目状 态等内容,具体信息见四川省建筑工人实名制基础信息数据标准 以下章节:项目信息在首次申报项目信息核验前,需先使用申请项目编码接口 API, 获取项目编码。5.4 项目数据上报在首次上报项目数据前, 项目需先通过项目信息申报核验。 项目 数据上报包括项目信息上报、考勤信息上报、进退场信息上报、工资信息上报、现场机械上报、 工人评价上

45、报等六个数据上报接口,可根 据项目数据更新情况,使用对应接口上报数据。5.4.1 项 目信息上报项目信息上报接口 API 的请求参数包括项目基本信息、 施工许可 证、人员信息采集设备、参建单位信息、项目班组基本信息、建筑工 人信息、管理人员信息、劳动合同信息、项目培训信息、银行卡信息 等内容,当项目信息发生变化时,需通过此接口及时上报更新,具体 信息见四川省建筑工人实名制基础信息数据标准以下章节:项目信息施工许可证人员信息采集设备参建单位信息项目班组信息项目班组基本信息建筑工人信息管理人员信息施工管理人员信息监理从业人员信息工人劳动合同信息项目培训信息培训基本信息培训详情信息银行卡信息企业银行卡信息个人银行卡信息在首次上报项目信息前, 需先使用申请人员信息采集设备编码接口 API,获取设备编码。5.4.2 考 勤信息上报考勤信息上报接口 API 的请求参数为工人最新考勤记录, 具体信 息见四川省建筑工人实名制基础信息数据标准以下章节:考勤记录信息5.4.3 进 退场信息上报进退场信息上报接口 API 的请求参数包括班组和工人最新进退 场记录等内容, 具体信息见 四川省建筑工人实名制基础信息数据标 准以下章节:班组进退场记录信息工人进退场记录信息5.4.4 工

温馨提示

  • 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
  • 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
  • 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
  • 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
  • 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
  • 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
  • 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。

评论

0/150

提交评论