【线上】发起企业授权书签署任务

更新时间:2025-04-07 11:50:52

接口描述

当企业用户需要委托平台方(应用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)

注意:

  • yyyy年MM月dd日形式
  • 截止时间会显示到授权协议内
  • 建议授权时间最长不超过3年

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"
    }
}


我要纠错