接口描述
当企业用户需要委托平台方(应用ID所属的开发者企业)进行自动盖章时,需要先通过该接口发起授权书的授权签署任务。
接口地址
点击下述蓝色字体{host}可跳转至API请求域名说明文档
https://{host}/v1/signAuthApi/online
请求方式
POST
请求数据格式
application/json; charset=UTF-8
请求参数
参数名称 | 参数位置 | 参数类型 | 必选 | 参数说明 |
accountId | Body | string | 是 | 机构账号ID(创建机构签署账号接口返回的orgId) |
transactorAccountId | Body | string | 是 | 签署授权书的经办人个人账号ID(创建个人签署账号接口返回的accountId) 注意:请传入能为企业操作盖章人员的账号,会绑定e签宝SaaS官网 |
sendNotice | Body | boolean | 否 | 是否给经办人账号中的联系方式(手机号/邮箱)发送e签宝通知签署链接,默认:true(发送通知) true - 发送通知 false - 不发送通知 |
validDate | Body | Long | 是 | 授权有效期截止时间(截止到当日23:59:59) 注意:
|
notifyUrl | Body | string | 否 | 回调通知地址,点击跳转 企业授权结果异步回调通知 授权签署结果通知平台,签署完成或者拒签触发回调 |
redirectUrl | Body | string | 否 | 授权签署完成后跳转页面,重定向到平台指定页面 |
响应参数
展开全部参数参数名称 | 参数类型 | 必选 | 参数说明 | |
code | int32 | 是 | 业务码,0表示成功,非0表示异常。 | |
message | string | 否 | 业务信息 请根据 code 来判断错误情况,不应该依赖 message 匹配,因为 message 可能会调整。 | |
data(点击“+”展开详情) | object | 否 | 业务数据 | |
authId | string | 否 | 授权流程ID |
请求示例
{
"accountId": "e803760fab9******605b3a973",
"transactorAccountId": "dcbc774a*******585673ee1",
"sendNotice": true,
"sealScope": "合同专用章",
"fileType": "全部",
"validDate": "20260221",
"notifyUrl": "http://notify.com.cn/callback/XXXXX",
"redirectUrl": "https://open.esign.cn"
}
响应示例
{
"code": 0,
"message": "成功",
"data": {
"authId": "5ab3d62ce9b******bf3712505"
}
}