回调通知Url地址配置方式和回调通知数据接收,详见签署回调通知接收说明。
当发起签署的文件加了打开密码或者文件已经损坏的情况,会在发起签署并成功开启签署流程后,异步触发此回调给开发者。开发者接受此回调,可发现签署文件异常,撤回签署流程,以免客户签署报错。
回调参数
参数名 | 必填 | 参数类型 | 说明 |
action | 是 | string | 标记该通知的业务类型,该通知固定为:FILE_UNAVAILABLE |
signFlowId | 是 | string | 签署流程ID |
fileId | 是 | string | 文件id |
fileName | 是 | string | 文件名称 |
description | 是 | string | 文件异常原因描述:文件已损坏/文件有打开密码 |
timestamp | 是 | int64 | 回调通知触发时间(如重试多次均返回第一次时间,毫秒级时间戳格式) |
通知示例
{ "action": "FILE_UNAVAILABLE", "signFlowId": "c11c57ba8*****e2fc944114b3", "fileId": "0d993dab****80bd9c5b12a210", "fileName": "test.pdf", "description": "文件已损坏/文件有打开密码", "timestamp": 1652153656713 }