接口描述
创建个人/机构图片印章
接口
/v1/accounts/{accountId}/seals/image
请求方式
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 | 印章别名（别名不能重复） | |
height | int32 | 否 | body | 印章高度, 个人默认95px, 机构默认159px | |
width | int32 | 否 | body | 印章宽度, 个人默认95px, 机构默认159px | |
type | string | 是 | body | 印章数据类型，BASE64：base64格式 | |
data | string | 是 | body | 印章数据，目前只支持png格式，base64格式字符串，不包含格式前缀 | |
transparentFlag | boolen | 否 | body | 是否对图片进行透明化处理，默认false。对于有背景颜色的图片，建议进行透明化处理，否则可能会遮挡文字 【注】透明化效果要在签署时候才能看到，单独下载印章图片看不到效果 |
公共响应参数
参数名称 | 类型 | 必选 | 参数说明 | 示例值 |
code | int | 是 | 业务码，0表示成功 | |
message | string | 否 | 信息 | |
data | object | 否 | 业务信息 |
响应参数
参数名称 | 类型 | 必选 | 参数说明 | 示例值 |
fileKey | string | 否 | 印章fileKey | |
sealId | string | 否 | 印章id | |
url | string | 否 | 印章下载地址, 有效时间1小时 | |
width | int | 否 | 印章宽度 | |
height | int | 否 | 印章高度 |
请求示例
POST https://openapi.esign.cn/v1/accounts/【账户id】/seals/image
{
"alias": "图片印章",
"data": "iVBORw0KGgoAAAANSUhEUgAAABsAAAAZCAYAAADAHFVeAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAADNSURBVEhLY3jKIPSfXnjUMqpgTMuYRP5/KKqG4xeKhnC5l9pWKHL48BvfSFRzgRjTMlbx/8jgjXcEXO5dUi5UlDD4tnYTqrlAPHgtexuW9P/PoydE4S8zF6CaC8QkWUYpHrUMjN/4RP7/efw0UfhTez+quUBMkmXDN+m/MnX+/7lnClH4XVwmqrlAPHgTCKWYJMueccv8fyGrSxR+LqKCai4QD94EMsQtYwQmcXNXOH4moAiXey6qiiKHD79QNUE1F4gxLaMhHq6WCf0HADhrew7JsbXmAAAAAElFTkSuQmCC",
"height": "100",
"width": "100",
"type": "BASE64"
}Postman请求示例
响应示例
{
"code":0,
"data":{
"sealId":"3ab4e747-3aba-4e03-99ac-6374b136daa6",
"width":100,
"fileKey":"$1f91e216-2543-4b63-bd9f-7a0b01bab250$4128181936",
"url":"https://esignoss.esign.cn/seal-service/44ac7b6e-198a-479a-8a7b-7db070861338/c14353ce-bab9-483a-bff1-ca887dce0e44-openseal.png?Expires=1569317332&OSSAccessKeyId=LTAIdvHfiVrzDKbE&Signature=9uz90P1aZ54r59ez6smQSDAqbBw%3D",
"height":100
},
"message":"成功"
}错误码
错误码 | 错误描述 | 解决方案 |
我要纠错