应用场景:通过调用一件事办件接口,向晋来办推送办件信息。
接口名称:一件事办件接口
接口地址:https://bmfw.jcgov.gov.cn/rest/onethinginfor/saveOneThingInfo
编码格式:x-www-form-urlencoded
参数说明:
(1)appcode(应用编码):申报应用审核通过后,平台会产生appcode。
(2)appsecret(应用密钥):申报应用审核通过后,平台会产生appsecret,在申报管理平台可以进行查看和重置。
(3) modulecode(服务编码):上架服务审核通过后,平台会产生modulecode。
(4)timestamp时间戳(10 位数字)生成方式:timestamp = System.currentTimeMillis()/1000+""。
(5) nonce随机数(UUID随机数)生成方式:UUID.randomUUID().toString()。
(6) sign签名信息:将data加密内容请求字典序升序排列后,用&号拼接在一起,如“k1=v1&k2=v2&k3=v3”+appsecret,排序后字符串以MD5(UTF-8)格式签名(小写)。
(7) data加密信息:data加密区请求数据通过AES加密标准,进行数据加密,加解密双方需要对解密后的数据进行签名验证。
请求参数说明
参数 | 参数类型 | 说明 |
appcode | String | 应用系统接入代码 |
modulecode | String | 服务模块接入代码 |
timestamp | String | 时间戳(10 位数字) |
nonce | String | 随机数 |
sign | String | 用其他字段和 appcode算出来的加密字符串 |
jlbId | String | 调用成功返回的数据id,用于更新数据。新增时为空 |
userName | String | 姓名 |
idCard | String | 身份证 |
title | String | 服务名 |
jointCoding | String | 联办编码 |
state | String | 数据状态 1:待受理 2:已受理 5:已办结 44:已退件 |
applyDate | String | 申请时间 |
ifEvaluate | String | 是否评价 0.没有评价 1已评价 |
jumpUrl | String | 详情地址 |
evaluateUrl | String | 评价填写地址 |
lookEvaluateUrl | String | 评价详情查看地址 |
type | String | 办件类型(举例:新生儿一件事) |
返回参数说明 | ||
参数 | 参数类型 | 说明 |
status | String | 发送状态 200:成功 300:异常 |
msg | String | 信息说明 |
JSON示例 | ||
{ state: 200, msg: 保存成功!, jlbId: ff8080816b872255016b8724e3570000 } |
一件事办件推送样例demo下载: