异步回调
回调说明
[!NOTE]
回调服务是指由君子签服务平台发起请求,调用客户端存在的http接口。用于异步的返回一些处理结果,如:签约完成、保全完成、企业审核结果、人脸结果返回等。
异步回调开通
[!NOTE]
回调地址应该是一个统一的接口URL,需将接口地址告诉君子签或登录君子签sass平台的自行设置(文件管理》API对接》回调地址设置)。(人脸的同步回调为发起时指定,是可以不同的)
回调签名及调用
[!NOTE]
君子签服务使用POST请求方式的Form表单结构的请求。即为form表单的post提交,不是application/json调用。
请求body中固定只有method,version,data,timestamp,sign,appkey 6个参数,其参数说明如下:
参数名 | 说明 | 是否必填(*是) | 请求方式 |
---|---|---|---|
method | 业务类型 | * | post |
version | 版本 | * | post |
timestamp | 时间戳(精确到毫秒) | * | post |
data | JSONObject结果 | * | post |
sign | 签名sign(sha1对前面的参数签名) | * | post |
appkey | appkey | * | post |
其中sign签名规则如下:
#签名方法
sign = sha1Hex("data"+data+"method"+method+"version"+version+"timestamp"+timestamp+"appKey"+appKey+"appSecret"+appSecret);
#例:
#"data{里面是一个json字符串}methodbank.three.statussign8b069524b034cc7797ff016457xxxxxxxxxxxxxxxxxxtimestamp1566201530099version1.0.0timestamp1566201530099appKey你的appkeyappSecret你的secret"
#取sha1的hex得:bfed014b33c5f216de5f9eb4a25e9a3ca14825e9
请求结果说明
[!NOTE]
君子签在调用客户接口后,客户端需返回一个json字符串,json字符串结构如下表;如果君子签收到success为false则服务端将在后面再次发送多次请求(3次,每次3分钟间隔),以保证发送成功。发送失败后进入死信对队,需要用户登录君子签查看回调查询,把fail的回调重新发送
参数名 | 说明 | 是否必填(*是) | 请求方式 |
---|---|---|---|
success | true成功false失败 | * | post |
msg | {"success":true} 或{"success":false,"msg":"处理失败了"},要注意返回结果字符串不能被””包裹。 | * | post |