回调通知参数说明
- e签宝通过HTTP协议,POST 方法进行通知推送,内容为 JSON 字符串;
- 对接方在接收到回调请求时,200 ~ 299 之间的 HTTP 状态码均会被e签宝通知服务认定为通知成功;
- 为了保障异步通知的可靠性,建议业务方在回调请求处理中,尽可能减少业务操作,改用异步方式处理后续业务流程。
参数名称 | 类型 | 必选 | 参数说明 | |
action | string | 是 | 标记该通知的业务类型,该通知固定为:ORG_SILENCESIGN_AUTH 【注】:开发者可以只关注当前action类型的回调(如果接收到其他附属通知内容可以忽略,例如:SIGN_MISSON_COMPLETE等) | |
organizeId | string | 是 | 企业账号ID | |
personId | string | 否 | 个人账号ID | |
authId | string | 是 | 授权流程ID | |
beginDate | Long | 否 | 授权生效时间(Unix时间戳格式,单位:毫秒) | |
endDate | Long | 否 | 授权失效时间(Unix时间戳格式,单位:毫秒) | |
status | int | 是 | 授权状态 2 - 授权成功 3 - 授权失败 【注】:授权失败可能原因:(1)线上授权:用户拒签授权书 (2)超过发起日90天,授权书仍未签署,任务过期导致授权失败 ((1)和(2)均需要重新发起授权) | |
authDes | string | 否 | 失败理由 |
通知内容示例:
成功示例:
{
"organizeId": "34C371D854D11E5E1CE53C26589B9575",
"personId": "",
"authId": "1752221196137039875",
"beginDate": 1706544000000,
"endDate": 17085398399000,
"status": 2,
"action": "ORG_SILENCESIGN_AUTH"
}
失败示例:
{
"organizeId": "34C371D854D11E5E1CE53C26589B9575",
"personId": "",
"authId": "1752261117406139393",
"beginDate": 1706544000000,
"endDate": 17085398399000,
"status": 3,
"authDes": "签署流程拒签",
"action": "ORG_SILENCESIGN_AUTH"
}
附 e签宝回调通知服务器信息
如果贵司需要防火墙配置后才允许e签宝消息通知服务推送数据,请根据下方信息进行贵司防火墙设置。
环境 | 公网IP |
沙箱模拟环境 | 47.96.79.204 |
线上正式环境 | 118.31.35.8 |