全国建筑工人管理服务信息平台数据标准
目 录
1 概述 .......................................................................................................................................1
1.1 简介 .......................................................................................................................................1
1.2 基本术语 ...............................................................................................................................1
1.3 接口调用方式 .......................................................................................................................1
1.4 接口响应 ...............................................................................................................................2
1.5 接口类型 ...............................................................................................................................4
1.5.1 异步处理接口................................................................................................................4
1.5.2 同步处理接口................................................................................................................5
2 接口详细信息 ........................................................................................................................6
2.1 企业........................................................................................................................................6
2.1.1 上传企业基本信息........................................................................................................6
2.1.2 查询企业基本信息........................................................................................................9
2.1.3 查询企业资质信息......................................................................................................11
2.2 项目......................................................................................................................................14
2.2.1 项目基本信息..............................................................................................................14
2.2.1.1 上传项目信息(政府自建平台) ............................................................................................14
2.2.1.2 修改项目信息(政府自建平台) ............................................................................................16
2.2.1.3 修改项目信息(软硬件企业) ................................................................................................19
2.2.1.3 查询项目信息.......................................................................................................................21
2.2.1.3 按区域查询项目(政府自建平台).........................................................................................24
2.2.2 项目参建单位..............................................................................................................28
2.2.2.1 上传参建单位.......................................................................................................................28
2.2.2.2 修改项目参建单位信息.......................................................................................................30
2.2.2.3 查询项目参建单位信息.......................................................................................................33
2.2.3 项目班组......................................................................................................................36
2.2.3.1 上传班组信息.......................................................................................................................36
2.2.3.2 修改班组信息.......................................................................................................................38
2.2.3.3 查询班组信息.......................................................................................................................40
2.2.4 项目人员......................................................................................................................46
2.2.4.1 上传项目工人信息...............................................................................................................46
2.2.4.2 修改项目工人信息...............................................................................................................49
2.2.4.3 查询项目工人信息...............................................................................................................53
2.2.5 项目人员进退场..........................................................................................................55
2.2.5.1 上传项目工人进/退场信息..................................................................................................55
2.2.5.2 查询项目工人进/退场信息..................................................................................................57
2.2.6 项目人员合同..............................................................................................................59
2.2.6.1 上传工人合同信息...............................................................................................................59
2.2.6.2 查询工人合同信息...............................................................................................................61
2.2.7 项目人员考勤..............................................................................................................64
2.2.7.1 上传工人考勤.......................................................................................................................64
2.2.7.2 查询工人考勤.......................................................................................................................66
2.2.8 项目人员工资..............................................................................................................69
2.2.8.1 上传工人工资.......................................................................................................................69
2.2.8.2 查询工人工资.......................................................................................................................72
2.2.9 项目培训......................................................................................................................75
2.2.9.1 上传项目培训.......................................................................................................................75
2.2.9.2 查询项目培训.......................................................................................................................79
2.3 人员 .....................................................................................................................................81
2.3.1 查询人员基本信息......................................................................................................81
2.3.2 查询人员资质..............................................................................................................84
2.4 诚信 .....................................................................................................................................88
2.4.1 企业..............................................................................................................................88
2.4.1.1 查询企业不良行为记录.......................................................................................................88
2.4.1.2 查询企业良好行为记录.......................................................................................................90
2.4.1.3 查询企业黑名单...................................................................................................................92
2.4.2 人员..............................................................................................................................94
2.4.2.1 查询工人不良行为记录.......................................................................................................94
2.4.2.2 查询工人良好行为记录.......................................................................................................96
2.4.2.3 查询工人黑名单...................................................................................................................98
2.5 异步接口调用结果查询 ...................................................................................................100
2.5.1 接口信息说明............................................................................................................100
3 数据字典............................................................................................................................101
3.1 企业登记注册类型字典表.................................................................................101
3.2 行政区划字典表.................................................................................................102
3.3 人员证件类型字典表.........................................................................................102
3.4 币种字典表.........................................................................................................103
3.5 企业资质资格类型字典表.................................................................................103
3.6 企业资质资格专业类别字典表.........................................................................104
3.7 企业资质等级字典表.........................................................................................110
3.8 企业资质取得方式字典表.................................................................................112
3.9 企业资质状态字典.............................................................................................112
3.10 项目分类字典表.................................................................................................113
3.11 项目状态字典表.................................................................................................113
3.12 立项级别字典表.................................................................................................114
3.13 建设规模字典表.................................................................................................114
3.14 建设性质分类字典表.........................................................................................114
3.15 工程用途字典表.................................................................................................115
3.16 国籍及地区字典表.............................................................................................116
3.17 参建单位类型字典表.........................................................................................116
3.18 工人工种字典表.................................................................................................116
3.19 银行代码字典表.................................................................................................118
3.20 是否字典表.........................................................................................................126
3.21 合同期限类型字典表.........................................................................................126
3.22 工人考勤方向字典表.........................................................................................127
3.23 工人进退场类型字典表.....................................................................................127
3.24 计量单位类型字典表.........................................................................................127
3.25 工人通行方式字典表.........................................................................................127
3.26 培训类型字典表.................................................................................................128
3.27 性别字典表.........................................................................................................128
3.28 政治面貌字典表.................................................................................................128
3.29 文化程度字典表.................................................................................................129
3.30 婚姻状况字典表.................................................................................................129
3.31 人员证书种类字典表.........................................................................................130
3.32 人员证书类型:安管证书专业字典表.............................................................130
3.33 人员证书类型:岗位证书专业字典表.............................................................130
3.34 人员证书类型:执业注册类别字典表.............................................................131
3.35 人员证书类型:执业注册证书专业字典表.....................................................132
3.36 人员证书类型:职业技能人员类别.................................................................134
3.37 人员资质等级:职称等级.................................................................................140
3.38 人员资质等级:职业技能等级.........................................................................140
3.39 资质证书状态字典表.........................................................................................141
3.40 企业不良行为字典表.........................................................................................141
3.41 认定部门级别字典表.........................................................................................155
3.42 市场主体类别字典表.........................................................................................155
3.43 人员不良行为字典表.........................................................................................155
3.44 附件类型字典表.................................................................................................161
3.45 银行卡业务类型字典表.....................................................................................161
3.46 异步处理结果状态字典表.................................................................................161
3.47 工人类型字典表.................................................................................................161
3.48 管理岗位字典表.................................................................................................161
1 概述
1.1 简介
全国建筑工人管理服务信息平台数据开放式接口 OpenAPI主要为第三方服 主要为第三方服 务商与全国建筑工人管理服信息平台进行数据交互使用 ;所有 API均基于 Post方式请求调用。
1.2 基本术语
接口提供方 (API Provider):接口 的定义和实现者,为调用方提供接口 的定义和实现者,为调用方提供合法访问的授权。
接口调用方 (API Client):接口 的调用者,需要从提供方获得所合法访问的授权。
接口端点 (API Endpoint):接口的 Http资源入口,由一个 资源入口,由一个 资源入口,由一个 Http URL所表示, 代表了一个或由参数确定的多接口集合。
1.3 接口调用方式
POST格式为: POST <API Endpoint>
参数列表
参数列表格式为:名 1=参数值 1&参数名 2=参数值 2……。
请求标准参数 参数名称 参数说明
method
由接口提供方指定的标识符。
version
由接口提供方指定的版本。注: 由接口提供方指定的版本。注: 由接口提供方指定的版本。注: 由接口提供方指定的版本。注: Endpoint+ method+version决定了接口的语义。
appid
由接口提供方分配给调用的身份标识符。
format
接口返回结果类型 :json
timestamp
调用方时间戳,格式为 “4位年 +2位月 +2位日 +2位小时 (24小时制 )+2位分 +2位秒 ”,用于接口提供方判断调的时 间,通常约定调用请求的时戳与接口提供方收到间差在约定的范围内。
nonce
随机数,由调用方生成在约定的时差范围内不可重复。 随机数,由调用方生成在约定的时差范围内不可重复。 随机数,由调用方生成在约定的时差范围内不可重复。 随机数,由调用方生成在约定的时差范围内不可重复。 随机数,由调用方生成在约定的时差范围内不可重复。 随机数,由调用方生成在约定的时差范围内不可重复。
sign
签名,按照生成算法计得来。
data
具体的接口方法中参数实信息(对象需要转换成 JSON String)
敏感信息(银行卡号, 证件码等)需要加密传输敏感信息(银行卡号, 证件码等)需要加密传输敏感信息(银行卡号, 证件码等)需要加密传输请使用 AES加密 ,算法 说明 :
算法密钥 =接入密钥 KEY,
编码 =UTF8,
加密模式 (CipherMode)=CBC,
填充模式 (PaddingMode)=PKCS7,
数据块 大小 (BlockSize)=128,
算法的初始化向量 (IV)= 接入密钥 KEY的前 16位字符 ,
加密后的字节数组转为 Base64字符串,需要加密的段会在备注中添 加‘ AES’标记。算法:密文 =Base64(AES(info, KEY))。
例如 :
RequestBody:
method=employee.create&format=json&version=1.0&appid=appcode123×tamp=20160614133300&nonce=321431&sign=23697537dc822216fdded329361f4311ea9f&data={"phone": ["12345678","87654321"],"name": "zhangsan","age": 100,"address": {"country": "china","province": "chengdu"},"married": false}
1.4 接口响应
统一返回参数结构 参数名称 参
code
处理结果编码(参考下面的 “标准错误代码定义 ”)
message
处理结果消息
data
接口处理完毕返回的数据(请参见具体信息)。
返回的 Json格式 :
{"code":"0","message":"","data":{ "phone":["12345678","87654321"],"name": "zhangsan"}}
标准 Code代码定义
0: 正确
-1: 请求参数错误
-2: 签名校验错误
-3: 无 API访问权限
-4: IP校验错误
-5: 访问超过限制
注:标准错误码小于 0,大于 0的错误码由各接口根据语义
自行定接口参数签名方法
(1)第一步:拼接参数字符串
将除 sign以外的请求参数(包括标准,除非有特别说明)按照名 称的字典升序排列,然后按此顺将 ”参数名=值 ”用”&”符号连接。 符号连接。
示例:
appid=appcode123&data={"phone":["12345678","87654321"],"name": "zhangsan","age":30,"address":{"country":"china","province":"chengdu"},"married":false}&format=json&method=employee.create&nonce=11223344×tamp=20160614133300&version=2.0
注意事项:
1) data参数必须 转换为 转换为 JSON格式的字符串。
2) 仅对接口定义中声明且请求参数列表包含的(括空值)进行签 名。
3) 参数值不作去除空格。
(2)第二步:在拼接 参数字符串后再&appsecret,如 &appsecret=df23hlir85353;appsecret即密钥,由全国建筑工人管理服务信息平台 即密钥,由全国建筑工人管理服务信息平台 即密钥,由全国建筑工人管理服务信息平台 技术支持人员提供。
示例:
appid=appcode123&data={"phone":["12345678","87654321"],"name": "zhangsan","age":100,"address":{"country":"china","province":"chengdu"},"married":false}&format=json&method=employee.create&nonce=11223344×tamp=20160614133300&version=2.0&appsecret=df23hlir85353gfgd86775jjdh6322
(3)第三步:将上一的获得字符串全部转换为小写。再进行 SHA256加密( SHA256 64位),生成的字符串就是验签数据 位),生成的字符串就是验签数据 sign。注意: SHA256加密 哈希值请转换为 16进制表示。
OpenAPI对验签数据 sign进行校验时不区分大小写。
访问频率限制
OpenAPI对访问过于频繁等情况做了屏蔽处理,针同一调用方 对访问过于频繁等情况做了屏蔽处理,针同一调用方 对访问过于频繁等情况做了屏蔽处理,针同一调用方 对访问过于频繁等情况做了屏蔽处理,针同一调用方 (API Client)访问同一方法这级别可以做如下限制 : 访问时间隔不能少于 1秒,且不允许 秒,且不允许 秒,且不允许 并发(即上一次访问还没有返回结果就开始下);具体限制参数可 并发(即上一次访问还没有返回结果就开始下);具体限制参数可 配置,会根据上线后实际业务数量和访问频率做优化调整。
部分内容由用户投稿或者来源于网络,如有侵权,请联系底部邮箱进行删除!非常感谢您的支持!