创建个人模板印章

更新时间：2022-09-08 15:54:13

接口描述

通过模版参数，创建个人印章

印章图片尺寸说明：【请点击】

接口

/v1/accounts/{accountId}/seals/personaltemplate

请求方式

POST

请求头

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

方式一：请求签名鉴权（优先推荐）

请求头入参示例如下：

参数名称	类型	必选	参数说明
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

请求参数

参数名称	类型	必选	参数类型	参数说明
accountId	string	是	path	用户id，该参数需放在请求地址里面，可以参考【请求示例】
alias	string	否	body	印章别名（别名不能重复）
color	string	是	body	印章颜色，（1）RED-红色（2）BLUE-蓝色（3）BLACK-黑色
height	int32	否	body	印章高度, 默认95px
width	int32	否	body	印章宽度, 默认95px
type	string	是	body	模板类型，说明：以下印章样式中正方形印章（SQUARE）支持长度为 2-4或7-9或14-16 个字符的姓名，其他印章样式支持长度为2-18个字符的姓名
				类型名	类型说明	印章示例
				BORDERLESS	无边框矩形印章
				RECTANGLE	带边框矩形印章
				SQUARE	正方形印章

公共响应参数

参数名称	类型	必选	参数说明
code	int	是	业务码，0表示成功
message	string	否	信息
data	object	否	业务信息

响应参数

参数名称	类型	必选	参数说明
fileKey	string	否	印章fileKey
sealId	string	否	印章id
url	string	否	印章下载地址, 有效时间1小时
height	int	否	印章高度, 默认95px
width	int	否	印章宽度, 默认95px

请求示例

POST https://openapi.esign.cn/v1/accounts/【账户id】/seals/personaltemplate

{"alias":"示例印章","color":"RED","type":"BORDERLESS"}

Postman请求示例

响应示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "sealId": "bcc6e3d4-339f-4795-beb6-8b4174xx",
        "fileKey": "$e435a0aa-2f35-4096-b583-61a4b7134076$xx",
        "url": "https://esignoss.esign.cn/seal-service/cd115f6e-13ba-4da0-8058-321edc4d133f/29edda83",
        "width": 95,
        "height": 95
    }
}

错误码

错误码	错误描述	解决方案
60000	印章创建失败: 印章上传文件系统失败: 接口HTTP请求失败	印章上传文件到阿里云偶发超时报错