回调通知参数说明
- e签宝通过HTTP协议,POST 方法进行通知推送,内容为 JSON 字符串;
- 对接方在接收到回调请求时,200 ~ 299 之间的 HTTP 状态码均会被e签宝通知服务认定为通知成功;
- 为了保障异步通知的可靠性,建议业务方在回调请求处理中,尽可能减少业务操作,改用异步方式处理后续业务流程。
参数名称 | 类型 | 必选 | 参数说明 | |
action | string | 是 | 标记该通知的业务类型,该通知固定为:SDK_EVIDENCE_REPORT | |
recordNo | string | 是 | 出证业务ID | |
status | string | 是 | 申请出证流程状态: SUCCESS(出证成功) FAILED(出证失败) | |
downloadUrl | string | 否 | 出证报告zip压缩包下载地址(包含出证报告以及存储的文件原文) | |
message | string | 否 | 出证失败原因 |
通知内容示例:
成功示例:
{
"downloadUrl": "https://esignoss.esign.cn/flash/811119d-ed2a-4ef8-8e90-96b2c2b7ad25/20230505094954576802.zip?Expires=1683337797&OSSAccessKeyId=LTAI4G23YViiKnxTC28ygQzF&Signature=nCoE4z2bFUM98FFQfAKItrq7JvQ%3D",
"action": "SDK_EVIDENCE_REPORT",
"recordNo": "20230*****576802",
"status": "SUCCESS"
}
失败示例:
{
"action": "SDK_EVIDENCE_REPORT",
"message": "出证失败",
"recordNo": "20230*******576810",
"status": "FAILED"
}
附 e签宝回调通知服务器信息
如果贵司需要防火墙配置后才允许e签宝消息通知服务推送数据,请根据下方信息进行贵司防火墙设置。
环境 | 公网IP |
沙箱模拟环境 | 47.96.79.204 |
线上正式环境 | 118.31.35.8 |