跳到主要内容

创建企业电子印章

1. 接口描述

接口请求域名: ess.tencentcloudapi.com 。

本接口(CreateSeal)用于创建企业电子印章,支持创建企业公章,合同章,财务专用章和人事专用章创建。

默认接口请求频率限制:20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称必选类型描述
ActionString公共参数,本接口取值:CreateSeal。
VersionString公共参数,本接口取值:2020-11-11。
RegionString公共参数,此参数为可选参数。
OperatorUserInfo执行本接口操作的员工信息。
注: 在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。
SealNameString电子印章名字,1-50个中文字符。
示例值:公司印章
AgentAgent代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
GenerateSourceString本接口支持上传图片印章及系统直接生成印章;
如果要使用系统生成印章,此值传:SealGenerateSourceSystem;
如果要使用图片上传请传字段 Image
示例值:SealGenerateSourceSystem
SealTypeString电子印章类型:

  • OFFICIAL-公章;
  • CONTRACT-合同专用章;
  • FINANCE-合财务专用章;
  • PERSONNEL-人事专用章.


示例值:OFFICIAL
FileNameString电子印章图片文件名称,1-50个中文字符。
示例值:印章图片.png
ImageString电子印章图片base64编码
参数Image,FileToken或GenerateSource=SealGenerateSourceSystem三选一。
示例值:imagecontentbase64
WidthInteger电子印章宽度,单位px
参数不再启用,系统会设置印章大小为标准尺寸。
示例值:10
HeightInteger电子印章高度,单位px
参数不再启用,系统会设置印章大小为标准尺寸。
示例值:20
ColorString电子印章印章颜色(默认红色RED),RED-红色

系统目前只支持红色印章创建。
示例值:Red
SealHorizontalTextString企业印章横向文字,最多可填15个汉字(若超过印章最大宽度,优先压缩字间距,其次缩小字号)
示例值:横向文字
SealChordTextString暂时不支持下弦文字设置
示例值:下弦文字
SealCentralTypeString系统生成的印章只支持STAR
示例值:Star
FileTokenString通过文件上传时,服务端生成的电子印章上传图片的token
SealStyleString印章样式,取值如下:


  • cycle:圆形印章;
  • ellipse:椭圆印章;
  • 注:默认圆形印章


示例值:cycle
SealSizeString印章尺寸取值描述:

  • 42_42 圆形企业公章直径42mm;
  • 40_40 圆形企业印章直径40mm;
  • 45_30 椭圆形印章45mm x 30mm;


示例值:42_42

3. 输出参数

参数名称类型描述
SealIdString电子印章ID,为32位字符串。
建议开发者保留此印章ID,后续指定签署区印章或者操作印章需此印章ID。
可登录腾讯电子签控制台,在 "印章"->"印章中心"选择查看的印章,在"印章详情" 中查看某个印章的SealId(在页面中展示为印章ID)。
示例值:429b82b40900a9f870a90d45c715bad7
RequestIdString唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 创建电子印章-通过图片base64创建企业公章

创建电子印章-通过图片base64创建企业公章

输入示例

POST / HTTP/1.1
Host: ess.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateSeal
<公共请求参数>

{
"Operator": {
"UserId": "11234567890123456789012345678901"
},
"SealName": "公司印章",
"Image": "imagecontentbase64",
"Width": 10,
"Height": 20,
"Color": "Red",
"SealType": "OFFICIAL",
"SealHorizontalText": "印章横向文字",
"SealChordText": "下弦文字",
"SealCentralType": "Star",
"FileName": "印章图片.png"
}

输出示例

{
"Response": {
"SealId": "429b82b4xxxx0a90d45c715bad7",
"RequestId": "62DDFFC6xxxxxA6-59152E3D129A"
}
}

示例2 通过企业印章横向文字创建企业圆形公章

通过企业印章横向文字创建企业圆形公章

输入示例

POST / HTTP/1.1
Host: ess.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateSeal
<公共请求参数>

{
"Operator": {
"UserId": "user-id-xxxx"
},
"GenerateSource": "SealGenerateSourceSystem",
"SealType": "OFFICIAL",
"SealName": "这是一个圆形电子印章名称",
"SealHorizontalText": "测试专业用章圆形横向一号",
"SealStyle": "circle"
}

输出示例

{
"Response": {
"SealId": "yDxxx12345xxx",
"RequestId": "s1692775850696494235"
}
}

示例3 通过企业印章横向文字创建椭圆形印章

通过企业印章横向文字创建椭圆形印章

输入示例

POST / HTTP/1.1
Host: ess.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateSeal
<公共请求参数>

{
"Operator": {
"UserId": "user-id-xxxx"
},
"GenerateSource": "SealGenerateSourceSystem",
"SealType": "OFFICIAL",
"SealName": "这是一个椭圆形电子印章名称",
"SealHorizontalText": "测试专业用椭圆印章一号",
"SealStyle": "ellipse"
}

输出示例

{
"Response": {
"SealId": "yDxxx1234556677xxx",
"RequestId": "s1692775850696494255"
}
}

5. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码描述
FailedOperation操作失败。
InternalError内部错误。
InternalError.Decryption解密失败。
InternalError.DependsApi依赖的第三方API返回错误。
InternalError.DependsDb数据库执行错误。
InternalError.Encryption加密失败。
InternalError.System系统错误,请稍后重试。
InvalidParameter.ParamError参数错误。
OperationDenied操作被拒绝。
OperationDenied.Forbid禁止此项操作。
OperationDenied.NoLogin用户未登录,请先登录后再操作。
OperationDenied.SubOrgNotJoin子企业暂未加入。