设置个人默认印章

更新时间:2020-12-16 14:25:30

接口描述

当账号存在多个印章,并需要更改默认印章的时候,开发者可以通过该接口将对应的印章设置为默认印章。

接口

/v1/accounts/{accountId}/seals/{sealId}/setDefault

请求方式

PUT

请求头

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

方式一:请求签名鉴权

请求头入参示例如下:

参数名称

类型

必选

参数说明

示例值

X-Tsign-Open-App-Id

string

项目ID

Content-Type

string

application/json;charset=UTF-8

X-Tsign-Open-Ca-Timestamp

string

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

Accept

string

建议统一填写 */*

X-Tsign-Open-Ca-Signature

string

签名字符串

Content-MD5

string

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

X-Tsign-Open-Auth-Mode

string

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

方式二:OAuth2.0鉴权

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

参数名称

类型

必选

参数说明

X-Tsign-Open-App-Id

string

项目ID

X-Tsign-Open-Token

string

通过获取鉴权Token接口返回

Content-Type

string

application/json; charset=UTF-8


请求参数

参数名称

类型

必选

参数类型

参数说明

示例值

accountIdstring

path个人签署账号id,通过创建个人签署账号接口获取

sealId

string

path

个人印章id

响应参数

参数名称

类型

必选

参数说明

示例值

codeint

业务码,0表示成功

messagestring

信息

dataobject

业务信息

请求示例  

PUT https://openapi.esign.cn/v1/accounts/【账号id】/seals/【印章id】/setDefault

响应示例

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

错误码

错误码错误描述解决方案

60000

印章创建失败: 印章上传文件系统失败: 接口HTTP请求失败

印章上传文件到阿里云偶发超时报错


我要纠错