全国建筑工人管理服务信息平台数据接口标准.DOCVIP

全国建筑工人管理服务信息平台数据接口标准 PAGE 1 PAGE 1 附件2 全国建筑工人管理服务信息平台 数据接口标准（试行） 目录 TOC \o 1-3 \h \z \u 1 概述 3 1.1 简介 3 1.2 基本术语 3 1.3 接口调用方式 3 1.4 接口响应 4 1.5 接口类型 6 1.5.1 异步处理接口 6 1.5.2 同步处理接口 6 2 接口详细信息 7 2.1企业 7 2.1.1 上传企业基本信息 7 2.1.2 查询企业基本信息 9 2.1.3 查询企业资质信息 11 2.2项目 13 2.2.1 项目基本信息 13 2.2.2 项目参建单位 19 2.2.3 项目班组 23 2.2.4 项目人员 27 2.2.5 项目人员进退场 34 2.2.6 项目人员合同 36 2.2.7 项目人员考勤 39 2.2.8 项目人员工资 41 2.2.9 项目培训 45 2.3 人员 48 2.3.1 查询人员基本信息 48 2.3.2上传人员资质信息 50 2.3.2 查询人员资质信息 51 2.3.4上传人员注册信息 53 2.3.5查询人员注册信息 54 2.4 诚信 55 2.4.1 企业 55 2.4.2 人员 60 2.5 异步接口调用结果查询 64 2.5.1 接口信息说明 64 3 数据字典 65 PAGE 1 PAGE 1 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.createformat=jsonversion=1.0appid=appcode123timestamp=20160614133300nonce=321431signc822216fdded329361f4311ea9fdata={phone: 87654321],name: zhangsan,age: 100,address: {country: china,province: chengdu},married: false} 1.4 接口响应 统一返回参数结构 参数名称 参数说明 code 处理结果编码（参考下面的“标准错误代码定义”） message 处理结果消息 data 接口处理完毕