接口描述
发起企业授权书签署适用于以下两种情形：
- authType=1（授权至平台）：当企业用户需要委托平台方（应用ID所属的开发者企业）进行自动盖章时，需要先通过该接口发起授权书的授权签署任务。
- authType=2（授权至经办人）：当企业用户需要委托某个经办人进行代企业签署盖章时，需要先通过该接口发起授权书的授权签署任务。
接口地址
http://ip:port/paas-sdk-service/timevale/auth/create
请求方式
POST
请求数据格式
application/json; charset=UTF-8
请求参数
参数名称 | 类型 | 必选 | 参数说明 |
organizeId | string | 是 | 授权方企业账号ID（创建企业签署账号接口返回） |
contact | string | 是 | 代委托方企业签署本授权书的经办人的联系方式：手机号或者邮箱 注意：请传入能为企业操作盖章人员的联系方式，会绑定e签宝SaaS官网的登录手机号/邮箱 |
sendNotice | boolean | 否 | 是否给经办人联系方式发送通知，默认：true（发送通知） true - 发送通知 false - 不发送通知 |
authType | int | 否 | 授权模式，默认为 1（授权至平台） 1 - 授权至平台，personId无需传 2 - 授权至经办人，personId必传 |
personId | string | 否 | 授权方经办人个人账号ID（创建个人签署账号接口返回） |
validDate | Long | 是 | 授权有效期截止时间（截止到当日23:59:59） 注意：
|
sealScope | string | 否 | 自定义授权印章范围，不传则默认为：全部 仅做为授权书内容的展示，不做接口校验。例如：合同专用章、人事专用章 |
fileType | string | 否 | 自定义签署文件类型，不传则默认为：全部 仅做为授权书内容的展示，不做接口校验。例如：借贷协议、运输协议、物流条款等 |
notifyUrl | string | 否 | 回调通知地址，点击了解 回调通知服务 授权签署结果通知平台，签署完成或者拒签触发回调 |
redirectUrl | string | 否 | 授权签署完成后跳转页面，重定向到平台指定页面 |
响应参数
参数名称 | 类型 | 必选 | 参数说明 |
errCode | int | 是 | 错误码，0标识成功，其他均标识失败 |
msg | string | 否 | 错误信息，错误码对应的说明信息 |
errorShow | boolean | 否 | 错误信息是否建议显示 |
authId | string | 否 | 授权流程ID |
请求示例
{
"organizeId": "ECFE673E29D741111C8A7E0ADCD377B3",
"authType": 1,
"contact": "15300001111",
"sendNotice": true,
"sealScope": "合同专用章",
"fileType": "全部协议",
"validDate": "1737875658000",
"notifyUrl": "http://notify.com.cn/callback/XXXXX",
"redirectUrl": "https://open.esign.cn"
}响应示例
{
"msg": "成功",
"errCode": 0,
"errShow": false,
"authId": "175401111114613763"
}
我要纠错