设置静默签署授权

更新时间:2021/01/26 17:45:26

接口描述

签署用户(个人/企业)如果需要自动盖章签署时,需要先通过该接口完成静默签署授权。


接口Url

/v1/signAuth/{accountId}


请求方式Method

POST


请求头Header

提供两种安全接入方式,开发者可选择其中一种方式进行对接,对应参数如何获取,参考文档【请点击】。

方式一:请求签名鉴权

请求头入参示例如下:

参数名称

参数类型

必选

参数位置

参数说明

X-Tsign-Open-App-Id

string

Header参数

应用ID,通过开放平台创建获取

Content-Type

string

Header参数

application/json;charset=UTF-8

X-Tsign-Open-Ca-Timestamp

string

Header参数

API 调用者传递时间戳,值为当前时间的毫秒数,也就是从1970年1月1日起至今的时间转换为毫秒,时间戳有效时间为15分钟,为了防重放攻击

Accept

string

Header参数

建议统一填写 */*

X-Tsign-Open-Ca-Signature

string

Header参数

签名字符串

Content-MD5

string

Header参数

当请求 Body 非 Form 表单时,可以计算 Body 的 MD5 值传递给云网关进行 Body MD5 校验。建议当请求 Body 非 Form 表单时,加上此请求头。

X-Tsign-Open-Auth-Mode

string

Header参数

选择请求方式进行鉴权,固定值,Signature

方式二:OAuth2.0鉴权

当安全接入选择OAuth2.0鉴权方式请点击查阅详情,请求头入参示例如下:

参数名称

参数类型

必选

参数位置

参数说明

X-Tsign-Open-App-Id

string

Header参数

应用ID,通过开放平台创建获取

X-Tsign-Open-Token

string

Header参数

通过获取鉴权Token接口返回

Content-Type

string

Header参数

application/json; charset=UTF-8


请求参数

参数名称

参数类型

必选

参数位置

参数说明

accountIdstring

Path参数

个人/机构签署账号ID,通过创建个人/机构签署账号接口获取
deadlinestring

Body参数

授权截止时间, 格式为yyyy-MM-dd HH:mm:ss,默认无限期

公共响应参数

参数名称

类型

必选

参数说明

codeint

业务码,0表示成功
messagestring

业务描述信息

dataobject

业务数据

请求示例  

POST https://openapi.esign.cn/v1/signAuth/{accountId}
{
    "deadline":"2020-09-26 11:00:00"
}

响应示例

{
    "code": 0,
    "message": "成功",
    "data": true
}

错误码

错误码错误描述解决方案