创建机构模板印章

更新时间：2022-09-08 15:56:09

接口描述

通过模版参数，创建机构印章，印章图片尺寸说明：【请点击】

接口

/v1/organizations/{orgId}/seals/officialtemplate

请求方式

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

请求参数

参数名称	类型	必选	参数类型	参数说明
orgId	string	是	path	机构id，该参数需放在请求地址里面，可以参考【请求示例】
alias	string	否	body	印章别名（别名不能重复）
color	string	是	body	印章颜色，RED-红色，BLUE-蓝色，BLACK-黑色
height	int32	否	body	印章高度，默认159px
width	int32	否	body	印章宽度，默认159px
htext	string	否	body	横向文，可设置0-8个字，企业名称超出25个字后，不支持设置横向文
qtext	string	否	body	下弦文，可设置0-20个字，企业企业名称超出25个字后，不支持设置下弦文
type	string	是	body	模板类型说明：以下印章样式支持长度为2-60个字符的机构名称
				TEMPLATE_ROUND	圆章
				TEMPLATE_OVAL	椭圆章
central	string	是	body	中心图案类型
				STAR	圆形有五角星
				NONE	圆形无五角星

公共响应参数

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

响应参数

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

请求示例

POST https://openapi.esign.cn/v1/organizations/【账户id】/seals/officialtemplate

{
    "alias": "芜浣的机构印章别名",
    "central": "STAR",
    "color": "RED",
    "height": 100,
    "width": 50,
    "htext": "横向文",
    "qtext": "下弦文",
    "type": "TEMPLATE_ROUND"
}

Postman请求示例

响应示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "sealId": "1c17fa52-812a-4149-a96b-1715351f8920",
        "fileKey": "$d17358ec-6e51-4983-a577-4ab0a5287096$2801526178",
        "url": "https://esignoss.oss-cn-hangzhou.aliyuncs.com/seal-service/4098bca8-a573-4f56-b57a-3310af86c0e2/c5459acf-ca7d-4af1-94e2-c79bd2a94b72-openseal.png?Expires=1569314426&OSSAccessKeyId=LTAIdvHfiVrzDKbE&Signature=FhML%2BqGTynAFn4XAVB4052XQG5s%3D",
        "width": 50,
        "height": 100
    }
}

错误码

错误描述

解决方案