社保api接口数据调用

1、社保接口文档V1.8.1腾海福州信用管理有限公司修订历史版本号日期修订人审阅人摘要V1.0.02017-05-22adminadmin文档创建V1.8.02017-09-04adminadmin将登录成功状态码0100改为信息提示码，通过info区分信息提示类型V1.8.12017-10-14adminadmin状态查询增加轮训退出标识isLeave内容目录社保接口文档 V1.8.0修订历史内容目录1 概述1.1 简介1.2 文档目的1.3 阅读对象2 安全控制2.1 请求认证2.1 账号密码加密传输3 接口调用流程3.1 接口调用流程图3.2 接口调用说明4 接口参数说明4.1 获取社保地区

2、列表4.1.1 提交方式4.1.2 输入参数4.1.3 输出参数4.2 获取社保登录 UI 元素4.2.1 提交方式4.2.2 输入参数4.2.3 输出参数错误!未定义书签。4.3 社保查询4.3.1 社保采集任务提交4.3.2 社保采集状态查询4.3.3 社保验证码输入4.3.4 社保采集结果查询4.4 结果回调通知4.4.1 提交方式4.4.2 通知参数4.4.3 成功响应5 附录5.1 状态码5.2 社保支持城市列表1 概述 1.1 简介立诚征信是一家互联网金融大数据公司,用大数据消除信息不对称，提供更快、更精准的信用决策。依托数据挖掘分析和机器学习技术，对申请者提交的信息进行识别，并结

3、合个人社交行为、运营商、身份属性、社保社保及海量互联网信息，对个人信用进行在线评分。基于强大的数据点基础，3 分钟即可完成评估。1.2 文档目的说明永讯征信与商户系统之间的信息流交换接口。1.3 阅读对象本文档的阅读对象为与永讯征信商户对接相关的业务人员、技术人员等。2 安全控制2.1 请求认证HTTP 请 求 header 添 加 ：au-appid：appid HTTP 请求 header 添加：au-randomstr：randomstrHTTP 请求 header 添加：au-sign：signHTTP 请求 header 添加：au-timestamp：timestampsign=m

4、d5(sha1(apisecret+randomstr)+timestamp)2.1 账号密码加密传输加密算法：base643 接口调用流程3.1 接口调用流程图3.2 接口调用说明获取社保地区列表MethodUrlDescGET获取支持的社保地区列表获取社保登陆 UI 元素MethodUrlDescGET根据 areaCode 获取该地区的s 社保登陆元素社保任务采集MethodUrlDescPOST社保采集任务提交GETkId 社保采集状态查询POST https:/社保验证码输kId/input/input入(短信验证码或图片验证码)GETakId社保采集结果查询回调通知MethodUr

5、lDescPOST商户提供的回调通知地址社保采集结果通知4 接口参数说明4.1 获取社保地区列表4.1.1 提交方式接口地址： 认证方式：apppid 认证请求方式：http get返回格式：json 响应模式：同步4.1.2 输入参数参数类型参数名称是否必填说明请求样例：4.1.3 输出参数参数类型参数名称是否必填说明codeString状态码是msgString状态描述是dataArray结果数据否areaCodeString地区代码是参照国家统计局地区代码规范areaNameString地区名称是城市名称pinYinString拼音是城市名称的全拼 (首字母大写)statusString

6、状态是0: 维护中1：正常"code":"0000","msg":"成功", "data":"areaName":"北京","areaCode":"1100","status":"00"响应样例：4.2 获取社保登录 UI 元素4.2.1 提交方式接口地址： 认证方式：apikey 认证请求方式：http get返回格式：json 响应模式：同步4.2.2 输入参数参数类型参数

7、名称是否必填说明areaCodeString地区码是社保地区码请求样例：4.2.3 输出参数参数类型参数名称是否必填说明codeString状态码是msgString状态描述是dataArray结果数据否labelString标签名称是城市名称nameString元素名是如：username 、password，对应接口字段的名称typeString类型是text:文本框password：密码框 select:下拉框promptString输入提示否requiredBoolean是否必须是false,trueregexString输入格式正则表达式否预留，暂未实现optionsArray列表框

8、元素否type=select 时不为空keyString选项 keyvalueString选项值"code":"0000","msg":"成功", "data":"label":"账号","name":"username","type":"text","prompt":"身份证号", "required ":true,

9、 "regex":"a-z+$ "，"label":"密码","name":"password","type":"password","prompt":"密码",响应样例："required ":true, "regex":"a-z+$ " 4.3 社保查询4.3.1 社保采集任务提交 提交方式接口地址： 认证方式：apik

10、ey 认证+sign 认证请求方式：http post返回格式：json 响应模式：异步 输入参数参数类型参数名称是否必填说明areaCodeString地区码是社保地区usernameString账号是社保登录账号passwordString密码否社保密码 base64identityNoString身份证号否身份证号nameString姓名否真实姓名mobileString手机号否手机号queryPwdString查询密码否查询密码uidString用户 id否商户系统的用户标识,用于区分商户的用户标识，建议填商户系统中用户名accessTypeString接入方式否可选值

11、api、h5、sdk，默认 apiareaCode=1100&username=87488778468&password =YmFjZGVm& accessType=api请求样例： 输出参数参数类型参数名称是否 必填说明codeString状态码是0010:受理成功 ,其他失败msgString状态描述是taskIdString任务 id是任务唯一标识"code": "0010”,“msg”:”受理成功”,"taskId ": "44ad3a799ad94a03b2514b8c6877df78&

12、quot; 响应样例：4.3.2 社保采集状态查询 提交方式提交地址： 认证方式：apikey 认证请求方式：http get返回格式：json 响应模式：同步 输入参数参数类型参数名称是否 必填说明taskIdString任务 id是任务 id(地址参数)请求样例： 输出参数参数类型参数名称是否 必填说明codeString状态码是msgString状态描述是taskIdString任务 id是inputobject输入项否(code=0002 时返回)typeString类型是sms:短信验证码 img:图片验证码valueString值是图片验证

13、码为 base64 编码格式waitSecondsString有效等待时是0 表示一直有效间infoString信息提示否(code=0100 时返回)login_success:登录成功"code": "0001","msg":"进行中", "input": "type":"","value":"","waitSeconds":"" 响应样例：4.3.3 社保验证码输入4.3

14、.2.1 提交方式提交地址： 认证方式：apikey 认证请求方式：http post返回格式：json 响应模式：同步 输入参数参数类型参数名称是否 必填说明inputString验证码是短信验证码或图片验证码input=3567请求样例： 输出参数参数类型参数名称是否 必填说明codeString状态码是0011:写入成功，其他失败msgString状态描述是taskIdString任务 id是"code": "0011”,"msg":"写入成功","taskId ": &

15、quot;44ad3a799ad94a03b2514b8c6877df78" 响应样例：4.3.4 社保采集结果查询 提交方式接口地址： 认证方式：apikey 认证+sign 认证请求方式：http get返回格式：json 响应模式：同步 输入参数参数类型参数名称是否 必填说明taskIdString任务 id是任务 id(地址参数) 请求样例： 输出参数参数类型参数名 称是否 必填说明codeString状态码是msgString状态描 述是dataObject数据对 象是data 数据对象字段说明如下"createDate&

16、quot;: "2016-11-26 12:12:10",数据生成时间(yyyy-MM-dd HH:mm:ss)"areaCode": "4201",地区码"basicInfo":基本信息"accNo": "1278589",社保账号"identityNo":"quot;,身份证号"name": "李鬼",姓名"gender": "男&qu

17、ot;,性别"birthday": "1988-04-16",出生日期(yyyy-MM-dd)"mobile": "quot;,手机号"email": "8234938432",邮件地址"address": "武汉市武昌区珞瑜路 138 号",通信地址"corpName": "武汉微创电子有限公司",缴纳企业名称"baseDeposit"："3000.0

18、0"，工资基数"accStatus": "normal",账号状态normal:正常 suspense:停缴 closed:销户"openDate": "2014-10-09"开户日期"insurances": 参保险种信息"insuranceType": "1",险种类型(1:养老保险 2：医疗保险 3：失业保险4：工伤保险 5：生育保险)"balance": "5500",余额"baseDep

19、osit": "2000.00",缴存基数"sumPayMonth": "24",累计缴费月数"dueToMonth": "2015-12-31",余额截止年月"firstPayDate": "2014-06-01",末首次缴费日期"lastPayDate ": "2015-05-01",最近一次缴费日期"insuranceStatus ": "2016-03-02"

20、账号状态normal:正常 suspense:停缴 closed:销户,"details": 缴费明细信息 "insuranceType": "1","accDate": "2016-07-11",日期(yyyy-MM-dd)"corpName": "武汉微创电子有限公司",单位名称"amt": "300.00",发生金额(收入为正、支出为负)"baseDeposit"："3000.00

21、"，缴费基数"payMonth”: "2015-06"，缴费年月(yyyy-MM)"bizDesc": "缴纳 2015-06 月社保"业务描述 响应样例："code": "0000”,"msg":"成功", "data": "createDate": "2016-11-26 12:12:10","areaCode": "4201", "

22、basicInfo":"accNo": "1278589", "identityNo":"quot;,"name": "李鬼","gender": "男","birthday": "1988-04-16","mobile": "quot;,"email": "823493843

23、2", "address": "武汉市武昌区珞瑜路 138 号", "corpName": "武汉微创电子有限公司", "baseDeposit"："3000.00"，"accStatus": "normal", "openDate": "2014-10-09""insurances": "insuranceType": "1"

24、,"balance": "5500","baseDeposit": "2000.00","sumPayMonth": "24","dueToMonth": "2015-12-31","firstPayDate": "2014-06-01","lastPayDate ": "2015-05-01","insuranceStatus ": &

25、quot;2016-03-02","details": "insuranceType": "1","accDate": "2016-07-11","corpName": "武汉微创电子有限公司", "amt": "300.00","baseDeposit"："3000.00"， "payMonth”: "2015-06"， "b

26、izDesc": "缴纳 2015-06 月社保"4.4 结果回调通知4.4.1 提交方式认证方式：apikey 认证+sign 认证请求方式：http post返回格式：json4.4.2 通知参数参数类型参数名称是否 必填说明uidString用户标识否用户查询请求中 uidbizTypeString业务类型是固定值codeString状态码是msgString状态描述是taskIdString任务 id是采集任务唯一 id地址：http:/商户在后台配置的 callBackUrl 参数：uidamp;bizType=socialSe

27、curity&code=0000&msg=成功&taskId=32956f2cb8d34978a9c9b1d461904ce8请求样例：4.4.3 成功响应响应数据说明success商户收到立木征信回调通知后，需回复 success 作为响应，否则认为回调失败，立木征信会重复通知，最多重复通知 5 次。通知频率：1m,5m,30m,2h,4h5 附录5.1 状态码返回码返回码描述0000成功 0001进行中 0002等待信息输入 0100信息提示 1001请求参数错误(错误原因) 1002authorization-key 错误 1003authorization-si

28、gn 签名错误 1004无接口访问权限 1005账户被冻结，请联系客服 1006账户余额不足，请充值 1007ip 未报备，限制访问 1008ip 请求次数限制超过当时上限 1020查询过于频繁，请稍后重试 1021查询超过当日最大限额，请明天再试 1030系统繁忙，请稍后重试 1100无效的 taskId 1101用户名或密码错误 1108密码输入错误次数过多，账户被锁定 1140网站异常，请稍后重试 1141网站繁忙，请稍后重试 1142操作失败,请稍后重试 3801官网暂停服务,请稍后重试5.2 社保支持城市列表序号地区代码地区名称1 1100 北京 2 1200 天津 3 1301 石

29、家庄 4 1302 唐山 5 1303 秦皇岛 6 1304 邯郸 7 1305 邢台 8 1306 保定 9 1307 张家口 10 1308 承德 11 1309 沧州 12 1310 廊坊 13 1311 衡水 14 1401 太原 15 1402 大同 16 1404 长治 17 1407 晋中 18 1408 运城 19 1410 临汾 20 1501 呼和 21 1504 赤峰 22 1505 通辽 23 1506 鄂尔多斯 24 1507 呼伦贝尔 25 2101 沈阳 26 2102 大连 27 2103 鞍山 28 2104 抚顺 29 2105 本溪 30 2106 丹东

30、31 2107 锦州 32 2108 营口 33 2111 盘锦 34 2201 长春 35 2202 吉林 36 2203 四平 37 2207 松原 38 2301 哈尔滨 39 2302 齐齐哈尔 40 2306 大庆 41 2310 牡丹江 42 2312 绥化 43 3100 上海 44 3201 南京 45 3202 无锡 46 3203 徐州 47 3204 常州 48 3205 苏州 49 3205YQ 苏州工业园区 50 3206 南通 51 3207 连云港 52 3208 淮安 53 3209 盐城 54 3210 扬州 55 3211 镇江 56 3212 泰州 57

31、3213 宿迁 58 3301 杭州 59 3301YH 杭州余杭区 60 3302 宁波 61 3303 温州 62 3304 嘉兴 63 3305 湖州 64 3306 绍兴 65 3307 金华 66 3308 衢州 67 3309 舟山 68 3310 台州 69 3311 丽水 70 3401 合肥 71 3402 芜湖 72 3403 蚌埠 73 3405 马鞍山 74 3408 安庆 75 3411 滁州 76 3412 阜阳 77 3413 宿州 78 3415 六安 79 3501 福州 80 3502 厦门 81 3503 莆田 82 3504 三明 83 3505 泉州

32、84 3506 漳州 85 3507 南平 86 3508 龙岩 87 3509 宁德 88 3601 南昌 89 3604 九江 90 3607 赣州 91 3608 吉安 92 3609 宜春 93 3610 抚州 94 3611 上饶 95 3701 济南 96 3702 青岛 97 3703 淄博 98 3704 枣庄 99 3705 东营 100 3706 烟台 101 3707 潍坊 102 3708 济宁 103 3709 泰安 104 3710 威海 105 3711 日照 106 3713 临沂 107 3714 德州 108 3715 聊城 109 3716 滨州 110 3717 菏泽 111 4101 郑州 112 4102 开封 113 4103 洛阳 114 4104 平顶山 115 4105 安阳 116 4107 新乡 117 4109 濮阳 118 4110