鹤山监管平台实名制数据接口标准
目录
一、引言
1.1编写目的
为加强省市区的建筑工程用工实名信息化监管系统对工人实名信息、工人考勤数据、分账管理及工资发放信息等统一管理，解决已有用工实名信息化管理系统与监管系统对接问题，实现数据实时对接和交换，特编写本接入标准供施工企业相关技术人员对接。
1.2适用范围
本文档的适用对象为信息科技公司的技术开发人员、日常维护人员。
1.3简称和术语
施工企业：指依法取得施工企业资质证书，在监管系统覆盖的省市区中从事建设施工活动的施工总承包企业、专业承包企业和劳务分包企业。
信息科技公司：指有资质开发并承包商业化实名制管理系统的信息科技公司。
二、开发规范
2.1通信协议
● 采用HTTP（或HTTPS）协议进行请求和响应的处理。接口请求采用GET/POST方式。接口响应返回JSON格式的数据。
● 由“监管系统”提供企业、项目、实名制、工资分账、考勤、事件等功能的接口地址。
● 接口请求URL地址：详见接口说明。
● 接口未注明处均使用UTF-8编码。
● HTTP（或HTTPS）请求参数均为字符串。
三、接口调用说明
接口实现分为两部分，一部分基于restful web服务。请求/响应将基于JSON数据格式，另外一部分Y一些链接的跳转，参数传递调用在url中完成
所有接口需要带有参数
参数名 | 参数值 |
appID | appID值 |
appToken | token值 |
测试地址：test.api.globalgood.vip
测试appID：hsdjtestljy
测试只需要根据4.2获取访问token接口获取对应的token
四、接口说明
● 所有接口响应的返回信息均以JSON字符串形式返回，可以使用JSON工具包对其进行解析。
● 返回信息具体字段参照接口说明中的响应参数，以下以举例：
处理成功：
{"rstCode":200,"rstMsg":"处理成功",”data”:null}
处理失败：
{"rstCode":101,"rstMsg":"签名错误",”data”:null}
● 返回结果码对照见参数表结果码对照表。
接口描述 | 获取App账号信息 |
请求方式 | Post |
请求地址 | http地址/AdminApi/Public/getAppInfoByAccount |
测试请求地址 | http测试地址/AdminApi/Public/getAppInfoByAccount |
请求参数
参数 | 必选 | 长度 | 注释 | 备注 |
account | true | 登陆账号 | ||
password | true | 登陆密码 |
响应参数
参数 | 限制 | 说明 |
rstCode | M | 返回结果码，数字类型。参考结果码字典表 |
rstMsg | O | 返回结果描述 |
data | O | Null |
{ | ||
接口描述 | 获取访问token |
请求方式 | Post |
请求地址 | http地址/AdminApi/Public/getTokenByAppAccount |
测试请求地址 | http测试地址/AdminApi/Public/getTokenByAppAccount |
请求参数
参数 | 限制 | 长度 | 注释 | 备注 |
appID | true | 接口4.1返回的appID | ||
appSecret | true | 接口4.1返回的appSecret |
响应参数
参数 | 限制 | 说明 |
rstCode | M | 返回结果码，数字类型。参考结果码字典表 |
rstMsg | O | 返回结果描述 |
data | O | |
{ | ||
接口描述 | 总包公司为项目添加参建单位信息；不为审核通过状态的项目也可通过此接口添加参建单位信息到项目； |
请求方式 | POST |
请求地址 | http地址/AdminApi/Company/addCompany |
测试请求地址 | http测试地址/AdminApi/Company/addCompany |
请求参数
参数 | 必选 | 长度 | 注释 | 备注 |
company | true | 企业名称 | ||
images | true | 营业执照 | ||
companynumber | true | 营业执照编码 | ||
linkman | true | 联系人 | ||
linkman_phone | true | 联系人电话 | ||
true | 邮箱 | |||
company_address | true | 企业地址 | ||
province | true | 省(通过地区字典获取) | ||
city | true | 市(通过地区字典获取) | ||
country | true | 区(通过地区字典获取) | ||
person | false | 企业编码 | ||
company_phone | false | 企业电话 | ||
fax | false | 传真 | ||
registration_time | false | 注册日期 | ||
registered_capital | false | 注册资金 | ||
registered_address | false | 注册地址 | ||
legal_representative | false | 企业法人代表 | ||
legal_representative_phone | false | 企业法人代表电话 | ||
license_number | false | 许可证编号 | ||
license_start_time | false | 许可证有效开始时间 | ||
license_end_time | false | 许可证有效结束时间 | ||
arbitration_number | false | 资质编号 | ||
arbitration_issuing_unit | false | 资质发放单位 | ||
main_arbitration | false | 主项资质 | ||
increase_arbitration | false | 增项资质 | ||
number_put_on_records | false | 备案编号 | ||
records_start_time | false | 备案有效开始时间 | ||
records_end_time | false | 备案有效结束时间 | ||
records_note | false | 备注 | ||
office_worker_number | false | 办公职工人数 | ||
related_certificates_number | false | 持证上岗人数 | ||
special_jobs_number | false | 特殊工种人数 | ||
qualification_number | false | 职业资格人数 | ||
copyright | false | 版权信息 |
响应参数
参数 | 限制 | 说明 |
rstCode | M | 返回结果码，数字类型。参考结果码字典表 |
rstMsg | O | 返回结果描述 |
data | O | Null |
部分内容由用户投稿或者来源于网络，如有侵权，请联系底部邮箱进行删除！非常感谢您的支持！
