四川省建筑工人管理服务信息平台数据共享交换接口标准(试行)【模板】

文章描述:-2022年3月29日发(作者:费淞) 四川省建筑工人管理服务信息平台 数据共享交换接口标准 (试行) 四川省住房和城乡建设厅 2018年9月 目 录 1接口说明 ............................................................................ 1 1.1实名核验接口 ................

-

四川省建筑工人管理服务信息平台数据共享交换接口标准(试行)【模板】2022年3月29日发(作者:费淞)




四川省建筑工人管理服务信息平台
数据共享交换接口标准
(试行)









四川省住房和城乡建设厅
2018年9月



目 录
1接口说明
............................................................................ 1
1.1实名核验接口
............................................................................ 1
1.2数据上报接口
............................................................................ 1
2接口方式
............................................................................ 2
2.1REST风格
............................................................................ 2
2.2公共参数
............................................................................ 2
2.2.1请求公共参数
............................................................................ 2
2.2.2返回公共参数
............................................................................ 3
2.2.3错误信息结构
............................................................................ 3
2.3访问控制
............................................................................ 4
1


2.4数据加密
............................................................................ 4
3接口流程
............................................................................ 4
4接口API
............................................................................ 6
4.1安全会话接口
............................................................................ 6
4.1.1 .......................................... securitylogin
............................................................................ 6
4.1.2 ....................................... securitylogout
............................................................................ 8
4.2实名制验证接口
............................................................................ 9
4.2.1 ..........................Verificationenterprise
............................................................................ 9
4.2.2 .......................... Verificationpersonnel
.......................................................................... 10
4.2.3 ................................ Verificationproject
.......................................................................... 12
4.2.4 ............... VerificationgetProjectCode
.......................................................................... 14
2


4.2.5 ............... VerificationgetDeviceCode
.......................................................................... 14
4.2.6 ........ VerificationgetProjectPayCode
.......................................................................... 16
4.2.7 ......................... VerificationretVeriInfo
.......................................................................... 17
4.3实名制数据上报接口
.......................................................................... 18
4.3.1 ....................................... Postenterprise
.......................................................................... 18
4.3.2 ........................................ Postpersonnel
.......................................................................... 19
4.3.3 ..............................................Postproject
.......................................................................... 20
4.3.4 ................................ PostprojectAttend
.......................................................................... 22
4.3.5 ............................ PostprojectEntryExit
.......................................................................... 23
4.3.6 ....................................... PostprojectPay
.......................................................................... 24
4.3.7 ........................ PostprojectMechanics
.......................................................................... 25
3


4.3.8 ............................ PostprojectAppraise
.......................................................................... 26
4.3.9 ........................................ PostretUpInfo
.......................................................................... 27
5接口内容
.......................................................................... 28
5.1企业实名核验
.......................................................................... 28
5.2建筑工人实名核验
.......................................................................... 29
5.3项目信息申报核验
.......................................................................... 29
5.4项目数据上报
.......................................................................... 29
5.4.1项目信息上报
.......................................................................... 30
5.4.2考勤信息上报
.......................................................................... 31
5.4.3进退场信息上报
.......................................................................... 31
5.4.4工资信息上报
.......................................................................... 31
4


5.4.5现场机械上报
.......................................................................... 32
5.4.6工人评价上报
.......................................................................... 32
5.5企业数据上报
.......................................................................... 32
5.6人员数据上报
.......................................................................... 33
6接口验证
.......................................................................... 33
6.1实名核验规则
.......................................................................... 33
6.1.1企业实名核验规则
.......................................................................... 33
6.1.2建筑工人实名核验规则
.......................................................................... 34
6.1.3项目信息核验规则
.......................................................................... 34
6.2信息上报验证规则
.......................................................................... 34
6.2.1项目数据上报验证规则
.......................................................................... 34
5


6.2.2企业数据上报验证规则
.......................................................................... 34
6.2.3人员数据上报验证规则
.......................................................................... 35

6


1 接口说明
四川省建筑工人管理服务信息平台提供“实名核验接口”、“数据
上报接口”两大类开放式服务接口。
1.1 实名核验接口
1) 企业实名核验接口:通过接口API提交企业实名认证资料,
省级建筑工人管理服务信息平台对企业基础信息进行校验,
通过后返回企业实名核验码;
2) 建筑工人实名核验接口:通过接口API建筑工人实名认证资
料,省级建筑工人管理服务信息平台对建筑工人身份进行校
验,通过后返回建筑工人实名核验码;
3) 项目信息申报核验接口:通过接口API申请项目编码,提交
项目基本资料,省级建筑工人管理服务信息平台对项目基本
信息进行校验,通过后返回项目核验码。
1.2 数据上报接口
1) 项目数据上报接口:通过项目信息上报、考勤信息上报、进
退场信息上报、工资信息上报、现场机械上报、工人评价上
报等六个接口API分别上报项目信息、参建单位信息、项目
班组信息、管理人员信息、工人培训信息、考勤记录信息、
工人及班组进退场记录、工人工资信息、施工现场机械信息、
建筑工人诚信评价信息等数据,省级建筑工人管理服务信息
平台进行数据更新和存储;
2) 企业数据上报接口:通过接口API上报企业基本信息、企业
1


资质证书信息、企业资质信息等数据,省级建筑工人管理服
务信息平台进行数据更新和存储;
3) 人员数据上报接口:通过接口API上报人员实名信息、人员
证书信息等数据,省级建筑工人管理服务信息平台进行数据
更新和存储。
2 接口方式
2.1 REST风格
建筑工人实名制数据接口API按照REST风格设计,通过HTTP
协议的GET方法或POST方法提交请求。
使用GET方法,请求参数通过URL查询参数(QueryParam)
提供。
使用POST方法,请求公共参数通过URL查询参数
(QueryParam)提供,接口专用参数通过请求正文(Body)、按照
JSO格式封装提供。
2.2 公共参数
建筑工人实名制数据接口API的请求和返回均包含规定的公共
参数,如无特殊说明,所有接口方法都包含以下请求公共参数以及返
回公共参数。
2.2.1 请求公共参数
参数名
access_token
必选

类型范围
String
说明
访问令牌。成功调用login接口后返回
2


sign
signCert
sign_method
timestamp




String
String
String
Date
请求参数签名值(预留)
签名证书序列号
签名方法(预留)
应用程序发出请求的客户端时间。平台
在接收到请求后,会与当前服务端时间
比较,如果在误差范围大于10分钟,将
请求视为无效
request_id 否 String 应用程序发出请求的唯一标识号。平台
如果在误差时间内接收到多个
request_id相同的请求,除最早收到的
一个请求外,其它请求将视为重放攻击
而被忽略
2.2.2 返回公共参数
参数名
ack_code
必选

类型范围
String
说明
接口调用是否成功
SUCCESS:成功
FAILURE:失败
errors
sign
sign_method
timestamp




List 错误信息
String
String
Date
请求参数签名值(预留)
签名方法(预留)
接口响应的服务端时间
3


correlation_id 否 String 对应的请求request_id。如果请求提供了
request_id参数,在响应时会原样返回
respe_id

否 String 接口返回的唯一标识号
2.2.3 错误信息结构
Error类
属性
code
message
inner_code
类型
String
String
String
长度
10
4000
50
可空



错误代码
错误信息描述
内部代码
说明
2.3 访问控制
接入单位通过接口只允许上报指定行政区划范围内的数据,每用
户并发请求数目必须小于10rs,即用户1s内最多请求10次,超过
则拒绝访问。
2.4 数据加密
敏感信息(号,证件号码等)需要加密传输,请使用AES
加密,算法说明:
算法密钥=接入密钥KEY,
编码=UTF-8,
加密模式(CipherMode)=CBC,
填充模式(PaddingMode)=PKCS7,
4


数据块大小(BlockSize)=128,
算法的初始化向量(IV)= 接入密钥KEY的前16位字符。
加密后的字节数组转为Base64字符串,需要加密的字段会在字
段备注中添加‘AES’标记。算法:密文=Base64(AES(info, KEY))。
3 接口流程
接口API调用流程分为三个步骤:
第一步:调用login创建安全会话获取access_token
调用安全会话接口的login方法,以创建会话获取访问令牌
access_token。
请求示例
POST https:{API_ROOT}securitylogin
Content-Type: applicationjson
{
:
返回结果
{
00
第二步:使用access_token调用接口API
把access_token作为请求的公共参数来调用建筑工人实名制接
口API。
请求示例
GET https:{API_ROOT}securityget_current_user?access_token=ACCESS_TOKE
返回结果
{
5



,
,
{

,用户
,
,市
,
,
,
,
,
,
}
}
第三步:调用logout注销会话
调用安全会话接口的logout方法,设置access_token为无效。
请求示例
POST https:{API_ROOT}securitylogout?access_token=ACCESS_TOKE
Content-Type: applicationjson
返回结果
{
6


4 接口API
4.1 安全会话接口
4.1.1 securitylogin
方法名称
login
方法说明
通过用户名和密码进行身份验证,验证成功后创建一个会话。所
有对数据和附件的管理操作都必须在有效的会话内进行,因此创建会
话是接口系统调用的第一个方法。
请求方法
POST
URL地址
https:{API_ROOT}securitylogin
访问权限
所有合法第三方程序。
请求参数
参数名
app_key
app_secret
account
password
必选




类型范围
String
String
String
String
说明
分配给应用程序的app_key
分配给应用程序的app_secret
用户账户名称
用户账户密码
7


参数名
org_code
必选

类型范围
String 管理员身份登录
说明
返回结果
参数名
access_toke
n
必选 类型范围 说明
是 String 登录成功则返回安全会话访问令牌
expires_in 是 Integer
访问令牌超时时间(以秒为单位),缺省24小

请求示例
POST https:{API_ROOT}securitylogin
Content-Type: applicationjson

{

,
,
,
}
返回示例
{

,
,
,
}
8


注意事项

4.1.2 securitylogout
方法名称
logout
方法说明
注销当前会话。
请求方法
POST
URL地址
https:{API_ROOT}securitylogout
访问权限
所有已登录用户。
请求参数

请求示例
POST https:{API_ROOT}securitylogout?access_token=ACCESS_TOKE
Content-Type: applicationjson
{
}
返回示例
{

,
9


}
注意事项

4.2 实名制验证接口
4.2.1 Verificationenterprise
方法名称
enterprise
方法说明
提交验证企业实名制信息,返回取信息号码。
请求方法
GET
URL地址
https:{API_ROOT} Verificationenterprise
访问权限
所有已登录用户。
请求参数
参数名
Companyame
SocialCreditumber
Representativeame
CellPhone
必选




类型范围
String
String
String
String
企业名称
社会统一信用代码
法定代表人姓名
法定代表人手机号
说明
10


参数名
Status
必选

类型范围
String
说明
企业经营状态

返回结果
{

, 取信息号码
,
}
请求示例
POST https:{API_ROOT}Verificationenterprise?access_token=ACCESS_TOKE
Content-Type: applicationjson
{
公司名
, 社会统一信用代码
, 法定代表人姓名
, 法定代表人电话号码
, 企业经营状态
}
4.2.2 Verificationpersonnel
方法名称
personnel
方法说明
11


提交验证人员实名制信息,返回取信息号码。
请求方法
GET
URL地址
https:{API_ROOT} Verification personnel
访问权限
所有已登录用户。
请求参数
参数名
Personame
Mobile
IDCardType
IDCardumber
CardFront
CardBack
PensonAndCard
ProfilePhoto
必选 类型范围
是 String
是 String
是 String
是 String
是 String
是 String
是 String
是 String
人员姓名
手机号码
证件类型
证件号码(AES)
身份证正面照片Base64(传入)
身份证背面照片Base64(传入)
手持身份证照片Base64(传入)
默认头像Base64(传入)
说明
返回结果
{

, 取信息号码
,
}
12


请求示例
POST https:{API_ROOT}Verificationpersonnel?access_token=ACCESS_TOKE
Content-Type: applicationjson
{
人员姓名
, 手机号码
, 证件类型
, 证件号码
, 身份证正面照片Base64编码
,

CardBack 身份证背面照片Base64(传入)
, 手持身份证照片Base64(传入)
, 默认头像Base64(传入)
}
4.2.3 Verificationproject
方法名称
personnel
方法说明
提交项目申报核验信息,返回取信息号码。
请求方法
GET
URL地址
https:{API_ROOT} Verification project
访问权限
13


所有已登录用户。
请求参数
参数名
ProjectCode
Projectame
ProjectCategory
Ownerame
BuildCorporationCode
AreaCode
Address
Invest
PrjSize
StartDate
CompleteDate
PrjStatus
必选 类型范围
是 String
是 String
是 String
是 String
是 String
是 String
是 String
是 String
是 String
是 String
是 String
是 String
项目编码
项目名称
项目类别
建设单位名称
建设单位统一社会信用代码
项目所在地
项目位置
项目投资额
项目规模
开工日期
拟竣工日期
项目状态
说明
返回结果
{

, 取信息号码
,
}
请求示例
POST https:{API_ROOT}Verification project?access_token=ACCESS_TOKE
14


Content-Type: applicationjson
{
项目编码
, 项目名称
, 项目类别
, 项目所在地
,…….
}
4.2.4 VerificationgetProjectCode
方法名称
getProjectCode
方法说明
申请项目编码,返回项目编码。
请求方法
GET
URL地址
https:{API_ROOT} VerificationgetProjectCode
访问权限
所有已登录用户。
请求参数

返回结果
{

15


,项目编码 ,
}
请求示例
POST https:{API_ROOT} VerificationgetProjectCode?access_token=ACCESS_TOKE
4.2.5 VerificationgetDeviceCode
方法名称
getDeviceCode
方法说明
申请人员信息采集设备编码,返回设备编码。
请求方法
GET
URL地址
https:{API_ROOT} Verification

getDeviceCode
访问权限
所有已登录用户。
请求参数
参数名
ProjectCode
DeviceType
DeviceBrand
DeviceModel
DeviceS
必选 类型范围
是 String
是 String
是 String
是 String
是 String
项目编码
类型
设备品牌
设备型号
设备序号
说明
16


参数名
DeviceHardwareS
必选 类型范围
是 String
说明
设备硬件唯一编号
返回结果
{

,设备编码 ,
}
请求示例
POST https:{API_ROOT} VerificationgetDeviceCode?access_token=ACCESS_TOKE
Content-Type: applicationjson
{
项目编码
, 类型
, 设备品牌
, 设备型号
, 设备序号
, 设备硬件唯一编号
}
4.2.6 VerificationgetProjectPayCode
方法名称
getProjectPayCode
方法说明
申请工资单编码,返回工资单编码。
17


请求方法
GET
URL地址
https:{API_ROOT}VerificationgetProjectPayCode
访问权限
所有已登录用户。
请求参数

返回结果
{

,工资单编码 ,
}
请求示例
POST https:{API_ROOT}VerificationgetProjectPayCode?
access_token=ACCESS_TOKE
4.2.7 VerificationretVeriInfo
方法名称
RetVeriInfo
方法说明
传入取信息号码,获取实名制验证结果。
请求方法
GET
18


URL地址
https:{API_ROOT} Verification RetVeriInfo
访问权限
所有已登录用户。
请求参数
参数名
ID
必选

类型范围
String 取信息号码
验证类型:
enterprise:企业实名制验证
Veri
Type
说明
是 String
personnel:个人实名制验证
project:项目信息制验证
返回结果
{

,
,
}
请求示例
POST https:{API_ROOT}Verification RetVeriInfo?access_token=ACCESS_TOKE
Content-Type: applicationjson
{
项目编号
,验证类型
}
19


4.3 实名制数据上报接口
4.3.1 Postenterprise
方法名称
enterprise
方法说明
上报企业信息,返回取信息号码。
请求方法
POST
URL地址
https:{API_ROOT} postenterprise
访问权限
所有已登录用户。
请求参数
参见“5.5 企业数据上报”。
返回结果
{

, 取信息号码 ,
}
请求示例
POST https:{API_ROOT} postenterprise?access_token=ACCESS_TOKE
Content-Type: applicationjson
{
企业基本信息
20


, 企业资质证书信息
, 企业资质信息
}
4.3.2 Postpersonnel
方法名称
personnel
方法说明
上报人员信息,返回取信息号码。
请求方法
POST
URL地址
https:{API_ROOT} post personnel
访问权限
所有已登录用户。
请求参数
参见“5.6 人员数据上报”。
返回结果
{

, 取信息号码
,
}
请求示例
21


POST https:{API_ROOT} post personnel?access_token=ACCESS_TOKE
Content-Type: applicationjson
{
, 人员基本信息
, 人员证书信息
}
4.3.3 Postproject
方法名称
project
方法说明
上报项目信息,返回取信息号码。
请求方法
POST
URL地址
https:{API_ROOT} post project
访问权限
所有已登录用户。
请求参数
参见“5.4.1 项目信息上报”。
返回结果
{

, 取信息号码
,
22


}
请求示例
POST https:{API_ROOT} post project?access_token=ACCESS_TOKE
Content-Type: applicationjson
{
项目信息
,施工许可证
,人员信息采集设备
,参建单位信息
, 项目班组基本信息
, 建筑工人信息
, 施工管理人员信息
, 监理从业人员信息
, 工人劳动合同信息
, 培训基本信息
, 培训详情信息
, 企业信息
, 个人信息
}
4.3.4 PostprojectAttend
方法名称
projectAttend
23


方法说明
考勤信息上报,返回取信息号码。
请求方法
POST
URL地址
https:{API_ROOT} post projectAttend
访问权限
所有已登录用户。
请求参数
参见“5.4.2 考勤信息上报”。
返回结果
{

, 取信息号码
,
}
请求示例
POST https:{API_ROOT} post projectAttend?access_token=ACCESS_TOKE
Content-Type: applicationjson
{

考勤记录信息

}
4.3.5 PostprojectEntryExit
方法名称
24


projectEntryExit
方法说明
班组和工人进退场信息上报,返回取信息号码。
请求方法
POST
URL地址
https:{API_ROOT} post projectEntryExit
访问权限
所有已登录用户。
请求参数
参见“5.4.3 进退场信息上报”。
返回结果
{

, 取信息号码
,
}
请求示例
POST https:{API_ROOT} post projectEntryExit?access_token=ACCESS_TOKE
Content-Type: applicationjson
{

班组进退场记录信息

,
工人进退场记录信息

}
25


4.3.6 PostprojectPay
方法名称
projectPay
方法说明
上报工人工资信息,返回取信息号码。
请求方法
POST
URL地址
https:{API_ROOT} post projectPay
访问权限
所有已登录用户。
请求参数
参见“5.4.4 工资信息上报”。
返回结果
{

, 取信息号码
,
}
请求示例
POST https:{API_ROOT} post projectPay?access_token=ACCESS_TOKE
Content-Type: applicationjson
{

工资单信息

26


,
工人工资信息

}
4.3.7 PostprojectMechanics
方法名称
projectMechanics
方法说明
上报现场机械设备信息,返回取信息号码。
请求方法
POST
URL地址
https:{API_ROOT} post projectMechanics
访问权限
所有已登录用户。
请求参数
参见“5.4.5 现场机械上报”。
返回结果
{

, 取信息号码
,
}
请求示例
POST https:{API_ROOT} post projectMechanics?access_token=ACCESS_TOKE
Content-Type: applicationjson
27


{

施工现场机械设备基本信息

,
施工现场机械使用信息

,
用油管理信息

}
4.3.8 PostprojectAppraise
方法名称
projectAppraise
方法说明
上报工人评价信息,返回取信息号码。
请求方法
POST
URL地址
https:{API_ROOT} post projectAppraise
访问权限
所有已登录用户。
请求参数
参见“5.4.6 工人评价上报”。
返回结果
{

, 取信息号码
,
}
28


请求示例
POST https:{API_ROOT} post projectAppraise?access_token=ACCESS_TOKE
Content-Type: applicationjson
{

工人奖励信息

,
工人不良行为信息

,
工人黑名单信息

,
班组评价信息

,
工人评价信息

}
4.3.9 PostretUpInfo
方法名称
RetUpInfo
方法说明
传入取信息号码,获取数据上报验证结果。
请求方法
GET
URL地址
https:{API_ROOT} Verification retUpInfo
访问权限
所有已登录用户。
请求参数
29


参数名
ID
必选

类型范围
String 取信息号码
上传类型:
说明
enterprise:企业数据上报
personnel:个人数据上报
project:项目信息上报
UpType 是 String projectAttend:考勤信息上报
projectEntryExit:进退场信息上报
projectPay:工资信息上报
projectMechanics:现场机械上报
projectAppraise:工人评价上报
返回结果
{

,
,
}
请求示例
POST https:{API_ROOT}Verification RetUpInfo?access_token=ACCESS_TOKE
Content-Type: applicationjson
{
项目编号
,上传类型
}
30


5 接口内容
5.1 企业实名核验
企业实名核验接口API的请求参数包括企业名称、统一社会信用
代码、法定代表人姓名、法定代表人手机号、经营状态等内容,具体
信息见《四川省建筑工人实名制基础信息数据标准》以下章节:

5.1 企业实名认证信息
5.2 建筑工人实名核验
建筑工人实名核验接口API的请求参数包括姓名、手机号码、证
件类型、证件号码、身份证正面照片、身份证背面照片、手持身份证
照片、默认头像等内容,具体信息见《四川省建筑工人实名制基础信
息数据标准》以下章节:

6.1 人员实名认证信息
5.3 项目信息申报核验
项目信息核验接口API的请求参数包括项目编码、项目名称、项
目类别、建设单位名称、建设单位统一社会信用代码、项目所在地、
项目位置、项目投资额、项目规模、开工日期、拟竣工日期、项目状
态等内容,具体信息见《四川省建筑工人实名制基础信息数据标准》
以下章节:

8.1 项目信息
在首次申报项目信息核验前,需先使用申请项目编码接口API,
31


获取项目编码。
5.4 项目数据上报
在首次上报项目数据前,项目需先通过项目信息申报核验。项目
数据上报包括项目信息上报、考勤信息上报、进退场信息上报、工资
信息上报、现场机械上报、工人评价上报等六个数据上报接口,可根
据项目数据更新情况,使用对应接口上报数据。
5.4.1 项目信息上报
项目信息上报接口API的请求参数包括项目基本信息、施工许可
证、人员信息采集设备、参建单位信息、项目班组基本信息、建筑工
人信息、管理人员信息、劳动合同信息、项目培训信息、信息
等内容,当项目信息发生变化时,需通过此接口及时上报更新,具体
信息见《四川省建筑工人实名制基础信息数据标准》以下章节:

8.1 项目信息
8.2 施工许可证
8.3 人员信息采集设备
8.4 参建单位信息
8.5 项目班组信息
8.5.1 项目班组基本信息
8.5.3 建筑工人信息
8.5.4 管理人员信息
8.5.4.1 施工管理人员信息
8.5.4.2 监理从业人员信息
32


8.5.6 工人劳动合同信息
8.6 项目培训信息
8.6.1 培训基本信息
8.6.1 培训详情信息
8.8信息
8.8.1企业信息
8.8.2个人信息
在首次上报项目信息前,需先使用申请人员信息采集设备编码接
口API,获取设备编码。
5.4.2 考勤信息上报
考勤信息上报接口API的请求参数为工人最新考勤记录,具体信
息见《四川省建筑工人实名制基础信息数据标准》以下章节:

8.5.7 考勤记录信息

5.4.3 进退场信息上报
进退场信息上报接口API的请求参数包括班组和工人最新进退
场记录等内容,具体信息见《四川省建筑工人实名制基础信息数据标
准》以下章节:

8.5.2 班组进退场记录信息
8.5.5 工人进退场记录信息

33


5.4.4 工资信息上报
工资信息上报接口API的请求参数包括最新工资单、工人工资等
内容,具体信息见《四川省建筑工人实名制基础信息数据标准》以下
章节:

8.5.8 工资单信息
8.5.9 工人工资信息
在每次上报工资单信息前,需先使用申请工资单编码接口API,
获取工资单编码。
5.4.5 现场机械上报
现场机械上报接口API的请求参数包括施工现场机械设备基本
信息,最新使用信息、用油管理信息等内容,具体信息见《四川省建
筑工人实名制基础信息数据标准》以下章节:

8.7 施工现场机械设备信息




8.7.1 施工现场机械基本信息
8.7.2 施工现场机械使用信息
8.7.3 用油管理信息
5.4.6 工人评价上报
工人评价上报接口API的请求参数包括最新工人奖励、工人不良
行为、工人黑名单以及班组和工人评价信息等内容,具体信息见《四
川省建筑工人实名制基础信息数据标准》以下章节:

34


9.2 工人奖励信息
9.3 工人不良行为信息
9.4 工人黑名单信息
9.5 评价信息



9.5.1 班组评价信息
9.5.2 工人评价信息
5.5 企业数据上报
在首次上报企业数据前,企业需先通过企业实名核验。企业数据
实名上报接口API的请求参数包括企业基本信息、企业资质证书信
息、企业资质信息等内容。当企业信息发生变化时,需通过此接口及
时上报更新,具体信息见《四川省建筑工人实名制基础信息数据标准》
以下章节:

5.2 企业基本信息
5.3 企业资质证书信息
5.4 企业资质信息
5.6 人员数据上报
在首次上报人员数据前,人员需先通过建筑工人实名核验。人员
数据上报接口API的请求参数包括人员基本信息、人员证书信息等内
容。当人员信息发生变化时,需通过此接口及时上报更新,具体信息
见《四川省建筑工人实名制基础信息数据标准》以下章节:

35


6.2 人员基本信息
6.3 人员证书信息
6 接口验证
系统通过接口获取到上报数据后,自动根据相关规则对上报数据
项进行有效性验证,主管部门在四川省建筑工人管理服务信息平台中
对通过自动验证的上报数据进行人工验证,验证通过后将数据存储到
建筑工人实名制数据库中。
6.1 实名核验规则
6.1.1 企业实名核验规则
系统检查企业名称、统一社会信用代码、法定代表人姓名、法定
代表人手机号等数据项是否填写完整,检验统一社会信用代码、法定
代表人手机号、企业经营状态等数据项是否规范。
6.1.2 建筑工人实名核验规则
系统检查建筑工人及管理人员姓名、手机号码、证件类型、证件
号码、身份证正面照片、身份证背面照片、手持身份证照片、默认头
像等数据项是否填写完整,检验手机号码、证件号码等数据项是否规
范。
6.1.3 项目信息核验规则
系统检查项目编码、项目名称、项目类别、建设单位名称、建设
单位统一社会信用代码、项目所在地、项目位置、项目投资额、项目
36


规模、开工日期、拟竣工日期、项目状态等数据项是否填写完整,检
验项目编码、统一社会信用代码、项目类别、项目状态等数据项是否
规范。
6.2 信息上报验证规则
6.2.1 项目数据上报验证规则
系统按照第“5.4 项目数据上报”中的上报内容要求,检查上报
数据表是否完整,验证各个数据表中的必填数据项是否填写完整,验
证项目编码、人员信息采集设备编码、工资单编码是否规范,检查上
报项目是否通过核验,检查项目各参建单位是否已经通过实名核验,
检查项目管理人员和建筑工人是否已经通过实名核验。
6.2.2 企业数据上报验证规则
系统按照第“5.5 企业数据上报”中的上报内容要求,检查上报
数据表是否完整,验证各个数据表中的必填数据项是否填写完整,检
查上报企业是否已经通过实名核验。
6.2.3 人员数据上报验证规则
系统按照第“5.6 人员数据上报”中的上报内容要求,检查上报
数据表是否完整,验证各个数据表中的必填数据项是否填写完整,检
查上报的人员是否已经通过实名核验。
37




四川省建筑工人管理服务信息平台
数据共享交换接口标准
(试行)









四川省住房和城乡建设厅
2018年9月



目 录
1接口说明
............................................................................ 1
1.1实名核验接口
............................................................................ 1
1.2数据上报接口
............................................................................ 1
2接口方式
............................................................................ 2
2.1REST风格
............................................................................ 2
2.2公共参数
............................................................................ 2
2.2.1请求公共参数
............................................................................ 2
2.2.2返回公共参数
............................................................................ 3
2.2.3错误信息结构
............................................................................ 3
2.3访问控制
............................................................................ 4
1


2.4数据加密
............................................................................ 4
3接口流程
............................................................................ 4
4接口API
............................................................................ 6
4.1安全会话接口
............................................................................ 6
4.1.1 .......................................... securitylogin
............................................................................ 6
4.1.2 ....................................... securitylogout
............................................................................ 8
4.2实名制验证接口
............................................................................ 9
4.2.1 ..........................Verificationenterprise
............................................................................ 9
4.2.2 .......................... Verificationpersonnel
.......................................................................... 10
4.2.3 ................................ Verificationproject
.......................................................................... 12
4.2.4 ............... VerificationgetProjectCode
.......................................................................... 14
2


4.2.5 ............... VerificationgetDeviceCode
.......................................................................... 14
4.2.6 ........ VerificationgetProjectPayCode
.......................................................................... 16
4.2.7 ......................... VerificationretVeriInfo
.......................................................................... 17
4.3实名制数据上报接口
.......................................................................... 18
4.3.1 ....................................... Postenterprise
.......................................................................... 18
4.3.2 ........................................ Postpersonnel
.......................................................................... 19
4.3.3 ..............................................Postproject
.......................................................................... 20
4.3.4 ................................ PostprojectAttend
.......................................................................... 22
4.3.5 ............................ PostprojectEntryExit
.......................................................................... 23
4.3.6 ....................................... PostprojectPay
.......................................................................... 24
4.3.7 ........................ PostprojectMechanics
.......................................................................... 25
3


4.3.8 ............................ PostprojectAppraise
.......................................................................... 26
4.3.9 ........................................ PostretUpInfo
.......................................................................... 27
5接口内容
.......................................................................... 28
5.1企业实名核验
.......................................................................... 28
5.2建筑工人实名核验
.......................................................................... 29
5.3项目信息申报核验
.......................................................................... 29
5.4项目数据上报
.......................................................................... 29
5.4.1项目信息上报
.......................................................................... 30
5.4.2考勤信息上报
.......................................................................... 31
5.4.3进退场信息上报
.......................................................................... 31
5.4.4工资信息上报
.......................................................................... 31
4


5.4.5现场机械上报
.......................................................................... 32
5.4.6工人评价上报
.......................................................................... 32
5.5企业数据上报
.......................................................................... 32
5.6人员数据上报
.......................................................................... 33
6接口验证
.......................................................................... 33
6.1实名核验规则
.......................................................................... 33
6.1.1企业实名核验规则
.......................................................................... 33
6.1.2建筑工人实名核验规则
.......................................................................... 34
6.1.3项目信息核验规则
.......................................................................... 34
6.2信息上报验证规则
.......................................................................... 34
6.2.1项目数据上报验证规则
.......................................................................... 34
5


6.2.2企业数据上报验证规则
.......................................................................... 34
6.2.3人员数据上报验证规则
.......................................................................... 35

6


1 接口说明
四川省建筑工人管理服务信息平台提供“实名核验接口”、“数据
上报接口”两大类开放式服务接口。
1.1 实名核验接口
1) 企业实名核验接口:通过接口API提交企业实名认证资料,
省级建筑工人管理服务信息平台对企业基础信息进行校验,
通过后返回企业实名核验码;
2) 建筑工人实名核验接口:通过接口API建筑工人实名认证资
料,省级建筑工人管理服务信息平台对建筑工人身份进行校
验,通过后返回建筑工人实名核验码;
3) 项目信息申报核验接口:通过接口API申请项目编码,提交
项目基本资料,省级建筑工人管理服务信息平台对项目基本
信息进行校验,通过后返回项目核验码。
1.2 数据上报接口
1) 项目数据上报接口:通过项目信息上报、考勤信息上报、进
退场信息上报、工资信息上报、现场机械上报、工人评价上
报等六个接口API分别上报项目信息、参建单位信息、项目
班组信息、管理人员信息、工人培训信息、考勤记录信息、
工人及班组进退场记录、工人工资信息、施工现场机械信息、
建筑工人诚信评价信息等数据,省级建筑工人管理服务信息
平台进行数据更新和存储;
2) 企业数据上报接口:通过接口API上报企业基本信息、企业
1


资质证书信息、企业资质信息等数据,省级建筑工人管理服
务信息平台进行数据更新和存储;
3) 人员数据上报接口:通过接口API上报人员实名信息、人员
证书信息等数据,省级建筑工人管理服务信息平台进行数据
更新和存储。
2 接口方式
2.1 REST风格
建筑工人实名制数据接口API按照REST风格设计,通过HTTP
协议的GET方法或POST方法提交请求。
使用GET方法,请求参数通过URL查询参数(QueryParam)
提供。
使用POST方法,请求公共参数通过URL查询参数
(QueryParam)提供,接口专用参数通过请求正文(Body)、按照
JSO格式封装提供。
2.2 公共参数
建筑工人实名制数据接口API的请求和返回均包含规定的公共
参数,如无特殊说明,所有接口方法都包含以下请求公共参数以及返
回公共参数。
2.2.1 请求公共参数
参数名
access_token
必选

类型范围
String
说明
访问令牌。成功调用login接口后返回
2


sign
signCert
sign_method
timestamp




String
String
String
Date
请求参数签名值(预留)
签名证书序列号
签名方法(预留)
应用程序发出请求的客户端时间。平台
在接收到请求后,会与当前服务端时间
比较,如果在误差范围大于10分钟,将
请求视为无效
request_id 否 String 应用程序发出请求的唯一标识号。平台
如果在误差时间内接收到多个
request_id相同的请求,除最早收到的
一个请求外,其它请求将视为重放攻击
而被忽略
2.2.2 返回公共参数
参数名
ack_code
必选

类型范围
String
说明
接口调用是否成功
SUCCESS:成功
FAILURE:失败
errors
sign
sign_method
timestamp




List 错误信息
String
String
Date
请求参数签名值(预留)
签名方法(预留)
接口响应的服务端时间
3


correlation_id 否 String 对应的请求request_id。如果请求提供了
request_id参数,在响应时会原样返回
respe_id

否 String 接口返回的唯一标识号
2.2.3 错误信息结构
Error类
属性
code
message
inner_code
类型
String
String
String
长度
10
4000
50
可空



错误代码
错误信息描述
内部代码
说明
2.3 访问控制
接入单位通过接口只允许上报指定行政区划范围内的数据,每用
户并发请求数目必须小于10rs,即用户1s内最多请求10次,超过
则拒绝访问。
2.4 数据加密
敏感信息(号,证件号码等)需要加密传输,请使用AES
加密,算法说明:
算法密钥=接入密钥KEY,
编码=UTF-8,
加密模式(CipherMode)=CBC,
填充模式(PaddingMode)=PKCS7,
4


数据块大小(BlockSize)=128,
算法的初始化向量(IV)= 接入密钥KEY的前16位字符。
加密后的字节数组转为Base64字符串,需要加密的字段会在字
段备注中添加‘AES’标记。算法:密文=Base64(AES(info, KEY))。
3 接口流程
接口API调用流程分为三个步骤:
第一步:调用login创建安全会话获取access_token
调用安全会话接口的login方法,以创建会话获取访问令牌
access_token。
请求示例
POST https:{API_ROOT}securitylogin
Content-Type: applicationjson
{
:
返回结果
{
00
第二步:使用access_token调用接口API
把access_token作为请求的公共参数来调用建筑工人实名制接
口API。
请求示例
GET https:{API_ROOT}securityget_current_user?access_token=ACCESS_TOKE
返回结果
{
5



,
,
{

,用户
,
,市
,
,
,
,
,
,
}
}
第三步:调用logout注销会话
调用安全会话接口的logout方法,设置access_token为无效。
请求示例
POST https:{API_ROOT}securitylogout?access_token=ACCESS_TOKE
Content-Type: applicationjson
返回结果
{
6


4 接口API
4.1 安全会话接口
4.1.1 securitylogin
方法名称
login
方法说明
通过用户名和密码进行身份验证,验证成功后创建一个会话。所
有对数据和附件的管理操作都必须在有效的会话内进行,因此创建会
话是接口系统调用的第一个方法。
请求方法
POST
URL地址
https:{API_ROOT}securitylogin
访问权限
所有合法第三方程序。
请求参数
参数名
app_key
app_secret
account
password
必选




类型范围
String
String
String
String
说明
分配给应用程序的app_key
分配给应用程序的app_secret
用户账户名称
用户账户密码
7


参数名
org_code
必选

类型范围
String 管理员身份登录
说明
返回结果
参数名
access_toke
n
必选 类型范围 说明
是 String 登录成功则返回安全会话访问令牌
expires_in 是 Integer
访问令牌超时时间(以秒为单位),缺省24小

请求示例
POST https:{API_ROOT}securitylogin
Content-Type: applicationjson

{

,
,
,
}
返回示例
{

,
,
,
}
8


注意事项

4.1.2 securitylogout
方法名称
logout
方法说明
注销当前会话。
请求方法
POST
URL地址
https:{API_ROOT}securitylogout
访问权限
所有已登录用户。
请求参数

请求示例
POST https:{API_ROOT}securitylogout?access_token=ACCESS_TOKE
Content-Type: applicationjson
{
}
返回示例
{

,
9


}
注意事项

4.2 实名制验证接口
4.2.1 Verificationenterprise
方法名称
enterprise
方法说明
提交验证企业实名制信息,返回取信息号码。
请求方法
GET
URL地址
https:{API_ROOT} Verificationenterprise
访问权限
所有已登录用户。
请求参数
参数名
Companyame
SocialCreditumber
Representativeame
CellPhone
必选




类型范围
String
String
String
String
企业名称
社会统一信用代码
法定代表人姓名
法定代表人手机号
说明
10


参数名
Status
必选

类型范围
String
说明
企业经营状态

返回结果
{

, 取信息号码
,
}
请求示例
POST https:{API_ROOT}Verificationenterprise?access_token=ACCESS_TOKE
Content-Type: applicationjson
{
公司名
, 社会统一信用代码
, 法定代表人姓名
, 法定代表人电话号码
, 企业经营状态
}
4.2.2 Verificationpersonnel
方法名称
personnel
方法说明
11


提交验证人员实名制信息,返回取信息号码。
请求方法
GET
URL地址
https:{API_ROOT} Verification personnel
访问权限
所有已登录用户。
请求参数
参数名
Personame
Mobile
IDCardType
IDCardumber
CardFront
CardBack
PensonAndCard
ProfilePhoto
必选 类型范围
是 String
是 String
是 String
是 String
是 String
是 String
是 String
是 String
人员姓名
手机号码
证件类型
证件号码(AES)
身份证正面照片Base64(传入)
身份证背面照片Base64(传入)
手持身份证照片Base64(传入)
默认头像Base64(传入)
说明
返回结果
{

, 取信息号码
,
}
12


请求示例
POST https:{API_ROOT}Verificationpersonnel?access_token=ACCESS_TOKE
Content-Type: applicationjson
{
人员姓名
, 手机号码
, 证件类型
, 证件号码
, 身份证正面照片Base64编码
,

CardBack 身份证背面照片Base64(传入)
, 手持身份证照片Base64(传入)
, 默认头像Base64(传入)
}
4.2.3 Verificationproject
方法名称
personnel
方法说明
提交项目申报核验信息,返回取信息号码。
请求方法
GET
URL地址
https:{API_ROOT} Verification project
访问权限
13


所有已登录用户。
请求参数
参数名
ProjectCode
Projectame
ProjectCategory
Ownerame
BuildCorporationCode
AreaCode
Address
Invest
PrjSize
StartDate
CompleteDate
PrjStatus
必选 类型范围
是 String
是 String
是 String
是 String
是 String
是 String
是 String
是 String
是 String
是 String
是 String
是 String
项目编码
项目名称
项目类别
建设单位名称
建设单位统一社会信用代码
项目所在地
项目位置
项目投资额
项目规模
开工日期
拟竣工日期
项目状态
说明
返回结果
{

, 取信息号码
,
}
请求示例
POST https:{API_ROOT}Verification project?access_token=ACCESS_TOKE
14


Content-Type: applicationjson
{
项目编码
, 项目名称
, 项目类别
, 项目所在地
,…….
}
4.2.4 VerificationgetProjectCode
方法名称
getProjectCode
方法说明
申请项目编码,返回项目编码。
请求方法
GET
URL地址
https:{API_ROOT} VerificationgetProjectCode
访问权限
所有已登录用户。
请求参数

返回结果
{

15


,项目编码 ,
}
请求示例
POST https:{API_ROOT} VerificationgetProjectCode?access_token=ACCESS_TOKE
4.2.5 VerificationgetDeviceCode
方法名称
getDeviceCode
方法说明
申请人员信息采集设备编码,返回设备编码。
请求方法
GET
URL地址
https:{API_ROOT} Verification

getDeviceCode
访问权限
所有已登录用户。
请求参数
参数名
ProjectCode
DeviceType
DeviceBrand
DeviceModel
DeviceS
必选 类型范围
是 String
是 String
是 String
是 String
是 String
项目编码
类型
设备品牌
设备型号
设备序号
说明
16


参数名
DeviceHardwareS
必选 类型范围
是 String
说明
设备硬件唯一编号
返回结果
{

,设备编码 ,
}
请求示例
POST https:{API_ROOT} VerificationgetDeviceCode?access_token=ACCESS_TOKE
Content-Type: applicationjson
{
项目编码
, 类型
, 设备品牌
, 设备型号
, 设备序号
, 设备硬件唯一编号
}
4.2.6 VerificationgetProjectPayCode
方法名称
getProjectPayCode
方法说明
申请工资单编码,返回工资单编码。
17


请求方法
GET
URL地址
https:{API_ROOT}VerificationgetProjectPayCode
访问权限
所有已登录用户。
请求参数

返回结果
{

,工资单编码 ,
}
请求示例
POST https:{API_ROOT}VerificationgetProjectPayCode?
access_token=ACCESS_TOKE
4.2.7 VerificationretVeriInfo
方法名称
RetVeriInfo
方法说明
传入取信息号码,获取实名制验证结果。
请求方法
GET
18


URL地址
https:{API_ROOT} Verification RetVeriInfo
访问权限
所有已登录用户。
请求参数
参数名
ID
必选

类型范围
String 取信息号码
验证类型:
enterprise:企业实名制验证
Veri
Type
说明
是 String
personnel:个人实名制验证
project:项目信息制验证
返回结果
{

,
,
}
请求示例
POST https:{API_ROOT}Verification RetVeriInfo?access_token=ACCESS_TOKE
Content-Type: applicationjson
{
项目编号
,验证类型
}
19


4.3 实名制数据上报接口
4.3.1 Postenterprise
方法名称
enterprise
方法说明
上报企业信息,返回取信息号码。
请求方法
POST
URL地址
https:{API_ROOT} postenterprise
访问权限
所有已登录用户。
请求参数
参见“5.5 企业数据上报”。
返回结果
{

, 取信息号码 ,
}
请求示例
POST https:{API_ROOT} postenterprise?access_token=ACCESS_TOKE
Content-Type: applicationjson
{
企业基本信息
20


, 企业资质证书信息
, 企业资质信息
}
4.3.2 Postpersonnel
方法名称
personnel
方法说明
上报人员信息,返回取信息号码。
请求方法
POST
URL地址
https:{API_ROOT} post personnel
访问权限
所有已登录用户。
请求参数
参见“5.6 人员数据上报”。
返回结果
{

, 取信息号码
,
}
请求示例
21


POST https:{API_ROOT} post personnel?access_token=ACCESS_TOKE
Content-Type: applicationjson
{
, 人员基本信息
, 人员证书信息
}
4.3.3 Postproject
方法名称
project
方法说明
上报项目信息,返回取信息号码。
请求方法
POST
URL地址
https:{API_ROOT} post project
访问权限
所有已登录用户。
请求参数
参见“5.4.1 项目信息上报”。
返回结果
{

, 取信息号码
,
22


}
请求示例
POST https:{API_ROOT} post project?access_token=ACCESS_TOKE
Content-Type: applicationjson
{
项目信息
,施工许可证
,人员信息采集设备
,参建单位信息
, 项目班组基本信息
, 建筑工人信息
, 施工管理人员信息
, 监理从业人员信息
, 工人劳动合同信息
, 培训基本信息
, 培训详情信息
, 企业信息
, 个人信息
}
4.3.4 PostprojectAttend
方法名称
projectAttend
23


方法说明
考勤信息上报,返回取信息号码。
请求方法
POST
URL地址
https:{API_ROOT} post projectAttend
访问权限
所有已登录用户。
请求参数
参见“5.4.2 考勤信息上报”。
返回结果
{

, 取信息号码
,
}
请求示例
POST https:{API_ROOT} post projectAttend?access_token=ACCESS_TOKE
Content-Type: applicationjson
{

考勤记录信息

}
4.3.5 PostprojectEntryExit
方法名称
24


projectEntryExit
方法说明
班组和工人进退场信息上报,返回取信息号码。
请求方法
POST
URL地址
https:{API_ROOT} post projectEntryExit
访问权限
所有已登录用户。
请求参数
参见“5.4.3 进退场信息上报”。
返回结果
{

, 取信息号码
,
}
请求示例
POST https:{API_ROOT} post projectEntryExit?access_token=ACCESS_TOKE
Content-Type: applicationjson
{

班组进退场记录信息

,
工人进退场记录信息

}
25


4.3.6 PostprojectPay
方法名称
projectPay
方法说明
上报工人工资信息,返回取信息号码。
请求方法
POST
URL地址
https:{API_ROOT} post projectPay
访问权限
所有已登录用户。
请求参数
参见“5.4.4 工资信息上报”。
返回结果
{

, 取信息号码
,
}
请求示例
POST https:{API_ROOT} post projectPay?access_token=ACCESS_TOKE
Content-Type: applicationjson
{

工资单信息

26


,
工人工资信息

}
4.3.7 PostprojectMechanics
方法名称
projectMechanics
方法说明
上报现场机械设备信息,返回取信息号码。
请求方法
POST
URL地址
https:{API_ROOT} post projectMechanics
访问权限
所有已登录用户。
请求参数
参见“5.4.5 现场机械上报”。
返回结果
{

, 取信息号码
,
}
请求示例
POST https:{API_ROOT} post projectMechanics?access_token=ACCESS_TOKE
Content-Type: applicationjson
27


{

施工现场机械设备基本信息

,
施工现场机械使用信息

,
用油管理信息

}
4.3.8 PostprojectAppraise
方法名称
projectAppraise
方法说明
上报工人评价信息,返回取信息号码。
请求方法
POST
URL地址
https:{API_ROOT} post projectAppraise
访问权限
所有已登录用户。
请求参数
参见“5.4.6 工人评价上报”。
返回结果
{

, 取信息号码
,
}
28


请求示例
POST https:{API_ROOT} post projectAppraise?access_token=ACCESS_TOKE
Content-Type: applicationjson
{

工人奖励信息

,
工人不良行为信息

,
工人黑名单信息

,
班组评价信息

,
工人评价信息

}
4.3.9 PostretUpInfo
方法名称
RetUpInfo
方法说明
传入取信息号码,获取数据上报验证结果。
请求方法
GET
URL地址
https:{API_ROOT} Verification retUpInfo
访问权限
所有已登录用户。
请求参数
29


参数名
ID
必选

类型范围
String 取信息号码
上传类型:
说明
enterprise:企业数据上报
personnel:个人数据上报
project:项目信息上报
UpType 是 String projectAttend:考勤信息上报
projectEntryExit:进退场信息上报
projectPay:工资信息上报
projectMechanics:现场机械上报
projectAppraise:工人评价上报
返回结果
{

,
,
}
请求示例
POST https:{API_ROOT}Verification RetUpInfo?access_token=ACCESS_TOKE
Content-Type: applicationjson
{
项目编号
,上传类型
}
30


5 接口内容
5.1 企业实名核验
企业实名核验接口API的请求参数包括企业名称、统一社会信用
代码、法定代表人姓名、法定代表人手机号、经营状态等内容,具体
信息见《四川省建筑工人实名制基础信息数据标准》以下章节:

5.1 企业实名认证信息
5.2 建筑工人实名核验
建筑工人实名核验接口API的请求参数包括姓名、手机号码、证
件类型、证件号码、身份证正面照片、身份证背面照片、手持身份证
照片、默认头像等内容,具体信息见《四川省建筑工人实名制基础信
息数据标准》以下章节:

6.1 人员实名认证信息
5.3 项目信息申报核验
项目信息核验接口API的请求参数包括项目编码、项目名称、项
目类别、建设单位名称、建设单位统一社会信用代码、项目所在地、
项目位置、项目投资额、项目规模、开工日期、拟竣工日期、项目状
态等内容,具体信息见《四川省建筑工人实名制基础信息数据标准》
以下章节:

8.1 项目信息
在首次申报项目信息核验前,需先使用申请项目编码接口API,
31


获取项目编码。
5.4 项目数据上报
在首次上报项目数据前,项目需先通过项目信息申报核验。项目
数据上报包括项目信息上报、考勤信息上报、进退场信息上报、工资
信息上报、现场机械上报、工人评价上报等六个数据上报接口,可根
据项目数据更新情况,使用对应接口上报数据。
5.4.1 项目信息上报
项目信息上报接口API的请求参数包括项目基本信息、施工许可
证、人员信息采集设备、参建单位信息、项目班组基本信息、建筑工
人信息、管理人员信息、劳动合同信息、项目培训信息、信息
等内容,当项目信息发生变化时,需通过此接口及时上报更新,具体
信息见《四川省建筑工人实名制基础信息数据标准》以下章节:

8.1 项目信息
8.2 施工许可证
8.3 人员信息采集设备
8.4 参建单位信息
8.5 项目班组信息
8.5.1 项目班组基本信息
8.5.3 建筑工人信息
8.5.4 管理人员信息
8.5.4.1 施工管理人员信息
8.5.4.2 监理从业人员信息
32


8.5.6 工人劳动合同信息
8.6 项目培训信息
8.6.1 培训基本信息
8.6.1 培训详情信息
8.8信息
8.8.1企业信息
8.8.2个人信息
在首次上报项目信息前,需先使用申请人员信息采集设备编码接
口API,获取设备编码。
5.4.2 考勤信息上报
考勤信息上报接口API的请求参数为工人最新考勤记录,具体信
息见《四川省建筑工人实名制基础信息数据标准》以下章节:

8.5.7 考勤记录信息

5.4.3 进退场信息上报
进退场信息上报接口API的请求参数包括班组和工人最新进退
场记录等内容,具体信息见《四川省建筑工人实名制基础信息数据标
准》以下章节:

8.5.2 班组进退场记录信息
8.5.5 工人进退场记录信息

33


5.4.4 工资信息上报
工资信息上报接口API的请求参数包括最新工资单、工人工资等
内容,具体信息见《四川省建筑工人实名制基础信息数据标准》以下
章节:

8.5.8 工资单信息
8.5.9 工人工资信息
在每次上报工资单信息前,需先使用申请工资单编码接口API,
获取工资单编码。
5.4.5 现场机械上报
现场机械上报接口API的请求参数包括施工现场机械设备基本
信息,最新使用信息、用油管理信息等内容,具体信息见《四川省建
筑工人实名制基础信息数据标准》以下章节:

8.7 施工现场机械设备信息




8.7.1 施工现场机械基本信息
8.7.2 施工现场机械使用信息
8.7.3 用油管理信息
5.4.6 工人评价上报
工人评价上报接口API的请求参数包括最新工人奖励、工人不良
行为、工人黑名单以及班组和工人评价信息等内容,具体信息见《四
川省建筑工人实名制基础信息数据标准》以下章节:

34


9.2 工人奖励信息
9.3 工人不良行为信息
9.4 工人黑名单信息
9.5 评价信息



9.5.1 班组评价信息
9.5.2 工人评价信息
5.5 企业数据上报
在首次上报企业数据前,企业需先通过企业实名核验。企业数据
实名上报接口API的请求参数包括企业基本信息、企业资质证书信
息、企业资质信息等内容。当企业信息发生变化时,需通过此接口及
时上报更新,具体信息见《四川省建筑工人实名制基础信息数据标准》
以下章节:

5.2 企业基本信息
5.3 企业资质证书信息
5.4 企业资质信息
5.6 人员数据上报
在首次上报人员数据前,人员需先通过建筑工人实名核验。人员
数据上报接口API的请求参数包括人员基本信息、人员证书信息等内
容。当人员信息发生变化时,需通过此接口及时上报更新,具体信息
见《四川省建筑工人实名制基础信息数据标准》以下章节:

35


6.2 人员基本信息
6.3 人员证书信息
6 接口验证
系统通过接口获取到上报数据后,自动根据相关规则对上报数据
项进行有效性验证,主管部门在四川省建筑工人管理服务信息平台中
对通过自动验证的上报数据进行人工验证,验证通过后将数据存储到
建筑工人实名制数据库中。
6.1 实名核验规则
6.1.1 企业实名核验规则
系统检查企业名称、统一社会信用代码、法定代表人姓名、法定
代表人手机号等数据项是否填写完整,检验统一社会信用代码、法定
代表人手机号、企业经营状态等数据项是否规范。
6.1.2 建筑工人实名核验规则
系统检查建筑工人及管理人员姓名、手机号码、证件类型、证件
号码、身份证正面照片、身份证背面照片、手持身份证照片、默认头
像等数据项是否填写完整,检验手机号码、证件号码等数据项是否规
范。
6.1.3 项目信息核验规则
系统检查项目编码、项目名称、项目类别、建设单位名称、建设
单位统一社会信用代码、项目所在地、项目位置、项目投资额、项目
36


规模、开工日期、拟竣工日期、项目状态等数据项是否填写完整,检
验项目编码、统一社会信用代码、项目类别、项目状态等数据项是否
规范。
6.2 信息上报验证规则
6.2.1 项目数据上报验证规则
系统按照第“5.4 项目数据上报”中的上报内容要求,检查上报
数据表是否完整,验证各个数据表中的必填数据项是否填写完整,验
证项目编码、人员信息采集设备编码、工资单编码是否规范,检查上
报项目是否通过核验,检查项目各参建单位是否已经通过实名核验,
检查项目管理人员和建筑工人是否已经通过实名核验。
6.2.2 企业数据上报验证规则
系统按照第“5.5 企业数据上报”中的上报内容要求,检查上报
数据表是否完整,验证各个数据表中的必填数据项是否填写完整,检
查上报企业是否已经通过实名核验。
6.2.3 人员数据上报验证规则
系统按照第“5.6 人员数据上报”中的上报内容要求,检查上报
数据表是否完整,验证各个数据表中的必填数据项是否填写完整,检
查上报的人员是否已经通过实名核验。
37

-

四川省建筑工人管理服务信息平台数据共享交换接口标准(试行)【模板】

发布时间:2022-03-29 20:22:39
文章版权声明:除非注明,否则均为IT技术网-学习WEB前端开发等IT技术的网络平台原创文章,转载或复制请以超链接形式并注明出处。

发表评论

评论列表 (有 16 条评论,86人围观)
豆瓣读书250V铁粉24 minutes ago Google Chrome 93.0.4577.82 Windows 10 x64
工人评价上报等六个数据上报接口
望京房产V铁粉20 minutes ago Google Chrome 93.0.4577.82 Windows 10 x64
企业资质信息等内容
深圳旺铺出租V铁粉14 minutes ago Google Chrome 93.0.4577.82 Windows 10 x64
} 请求示例 21 POST https
泰康人寿陈东升V铁粉18 minutes ago Google Chrome 93.0.4577.82 Windows 10 x64
项目类别
红馆ktv团购V铁粉26 minutes ago Google Chrome 93.0.4577.82 Windows 10 x64
建筑工人诚信评价信息等数据
水培V铁粉25 minutes ago Google Chrome 93.0.4577.82 Windows 10 x64
项目名称
舒筋健腰丸V铁粉3 minutes ago Google Chrome 93.0.4577.82 Windows 10 x64
编码=UTF-8
技校V铁粉11 minutes ago Google Chrome 93.0.4577.82 Windows 10 x64
取信息号码
深度系统优化工具V铁粉14 minutes ago Google Chrome 93.0.4577.82 Windows 10 x64
applicationjson { 工人奖励信息
海精灵V铁粉0 second ago Google Chrome 93.0.4577.82 Windows 10 x64
} 请求示例 POST https
俺去也防屏蔽V铁粉19 minutes ago Google Chrome 93.0.4577.82 Windows 10 x64
{API_ROOT} post projectPay 访问权限 所有已登录用户
奇犽V铁粉16 minutes ago Google Chrome 93.0.4577.82 Windows 10 x64
获取工资单编码
海宁人才V铁粉2 minutes ago Google Chrome 93.0.4577.82 Windows 10 x64
applicationjson { 工资单信息 26
风热咳嗽食疗V铁粉23 minutes ago Google Chrome 93.0.4577.82 Windows 10 x64

最近发表

随便看看

热门文章

标签列表