1、 接口未注明处均使用UTF-8编码。 通信过程中涉及的中文或特殊符号的传输,需进行urlencode处理。 HTTP(或HTTPS)请求参数均为字符串。 接口请求需进行签名,详见2.2通信安全一节。2.2通信安全为保证数据传输过程中的数据真实性,我们需要对数据进行数字签名,在接收签名数据之后进行签名校验。“信息平台”会为施工企业的每个工程分配唯一的接入编号和接入密钥。签名机制如下: 对全部有长度限制的传输字段(不包括NL类型的字段)进行签名,将参数名(区分大小写)和参数值(需进行urlencode处理)用“=”连接,参数值为空的参数不参与签名,参数之间用“&”连接,格式是:param1=val
2、1¶m2=val2。 参数组装顺序规则:参数名的字典顺序。 密钥拼接方式为传输参数直接连接密钥,如只有param1和param2两参数,值分别为val1和val2,密钥为key,拼接结果为:param2=val2key。 使用“信息平台”分配的密钥进行MD5加密(密钥直接跟在组装好的参数后即可),将值赋给sign参数。 敏感信息班组编号、身份证图片路径、身份证号、银行卡号、社保号需要加密传输,使用DES加密,加密key等于接入密钥,加密后的字节码转为16进制编码的字符串,并在密文字符串的前面加“des:”前缀。算法:密文=”des:” + HEX(DES(idcard, key),如:
3、身份证号:511301*1,接入密钥:8c2da4c769828fcfa77aedb690999cf9,密文:des:80cfe03525bb2b8d43d62ff369e95334cd1facfe4bbb800c2.3注意事项 接口中各项参数当标识是M时参数必选,为O时可选。 接口字段长度分为三种:无限制(NL),固定长度(FL),可变长度(VL)。如果为FL,则长度必须精确到FL后跟随的数字,格式举例FL14;如果为VL,则长度在可变范围内即可,如果长度不够,不补空格或其它字符,格式举例VL30。 接口说明中,若参数字体为红色,请仔细阅读备注说明。 请求返回结果码不为0时,需要再次提交请求
4、。如果结果码大于0,则需要根据提示信息修改错误后再次提交;如果结果码小于0,可以间隔一段时间再提交(如:选择间隔5分钟、10分钟、30分钟、1小时提交一次,连续5次提交不成功时推迟到第二天再提交)。三、接口说明 所有接口响应的返回信息均以JSON字符串形式返回,可以使用JSON工具包对其进行解析。 返回信息具体字段参照接口说明中的响应参数,以下以举例:处理成功:resultCode:0,resultDesc处理成功处理失败:1,签名错误 返回结果码对照见附录4.2结果码对照表。3.1新增班组接口说明接口描述施工企业添加班组时调用请求地址/smz/team/save测试请求地址请求参数参数限制长
5、度注释备注accessNoMFL32接入编号“信息平台”为施工企业分配的接入编号teamCodeVL320班组编码工程内部的班组唯一编码,如果班组编码已存在则修改班组。格式:班组长身份证号 + 班组类型代码,使用DES加密nameVL40班组名称班组命名格式:班组长姓名 + 班组类型 + “班组”workTypeVL32班组类型参考附录4.3leaderAppointmentOVL400班组长证明书外网能访问的URL路径,“信息平台”会自动抓取leaderIdcardVL150工人身份证号检查工人是否存在的依据,使用DES加密leaderNameVL30工人姓名leaderSexFL1性别M:
6、男 F:女leaderNation民族leaderBirthdayFL8生日yyyyMMddleaderAddress住址身份证上的住址leaderSignOrgan签发机关身份证的签发机关leaderExpiryStart有效期开始日期身份证有效期开始日期leaderExpiryEnd有效期结束日期身份证有效期结束日期,为空表示长期leaderHeadImg身份证头像URLleaderIdcardFrontVL1500身份证正面照外网能访问的URL路径,“信息平台”会自动抓取,使用DES加密leaderIdcardBack身份证反面照leaderCurrentAddress常住地址近期的常住
7、地址leaderPolitical政治面貌0:党员 1:团员 2:群众leaderEducation文化程度本科以上、本科、大专、中专、高中、初中及以下leaderPhoneVL11手机号leaderEmployType用工形式固定工人 1:外聘leaderTechLevel技能水平无(普通);1:初级工;2:中级工;3:高级工;4:技师;5:高级技师leaderContractCodeVL50合同编号施工企业内部的合同编号。leaderContractFile合同附件外网能访问的URL路径,“信息平台”会自动抓取。leaderCardNum工资卡账号使用DES加密leaderCardBank
8、VL10工资卡开户行代码参考附录4.4leaderWorkType工种代码leaderSecurityCodeVL300社保号leaderSafetyEdu是否参加安全教育true: 是;false:否leaderSafetyEduImg安全教育图片leaderBuilderType工人类型建筑工匠;建筑产业技术工人;其他leaderDoDate进场日期timestampFL17时间戳北京时间精确到毫秒(yyyyMMddHHmmssSSS)sign签名响应参数说明resultCode返回结果码,数字类型。0表示成功;其它表示失败。resultDesc返回结果描述3.2修改班组施工企业修改班组时调用/smz/team/update3.3添加班组工人接口说
copyright@ 2008-2022 冰豆网网站版权所有
经营许可证编号:鄂ICP备2022015515号-1