创建企业电子印章
1. 接口描述
接口请求域名： essbasic.tencentcloudapi.com 。
可以通过图片为子客企业代创建印章，图片最大5MB
可以系统创建子客企业代创建印章, 系统创建的印章样子下图(样式可以调整)
默认接口请求频率限制：20次/秒。
推荐使用 API Explorer
点击调试API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：CreateSealByImage。 |
| Version | 是 | String | 公共参数，本接口取值：2021-05-26。 |
| Region | 否 | String | 公共参数，此参数为可选参数。 |
| Agent | 是 | Agent | 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。 此接口下面信息必填。
第三方平台子客企业和员工必须已经经过实名认证 |
| SealName | 是 | String | 电子印章名字，1-50个中文字符 注: 同一企业下电子印章名字不能相同 |
| SealImage | 否 | String | 电子印章图片base64编码，大小不超过10M（原始图片不超过5M），只支持PNG或JPG图片格式 注: 通过图片创建的电子印章，需电子签平台人工审核 |
| GenerateSource | 否 | String | 电子印章生成方式
|
| SealType | 否 | String | 电子印章类型 , 可选类型如下:
注: 同企业下只能有一个公章, 重复创建会报错示例值：OFFICIAL |
| SealHorizontalText | 否 | String | 企业印章横向文字，最多可填15个汉字 (若超过印章最大宽度，优先压缩字间距，其次缩小字号) 横向文字的位置如下图中的"印章横向文字在这里"  示例值：横向文字 |
| SealStyle | 否 | String | 印章样式, 可以选择的样式如下:
示例值：cycle |
| SealSize | 否 | String | 印章尺寸取值描述, 可以选择的尺寸如下:
示例值：42_42 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| SealId | String | 电子印章ID，为32位字符串。 建议开发者保留此印章ID，后续指定签署区印章或者操作印章需此印章ID。 |
| ImageUrl | String | 电子印章预览链接地址，地址默认失效时间为24小时。 注: 图片上传生成的电子印章无预览链接地址注意：此字段可能返回 null，表示取不到有效值。 示例值：https://file.ess.tencent.cn/bresource/resource/resource/0/0.PNG?hkey=a6cdd6******64d4 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 系统生成印章
GenerateSource为SealGenerateSourceSystem表示系统生成印章
输入示例
POST / HTTP/1.1
Host: essbasic.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateSealByImage
<公共请求参数>
{
"Agent": {
"AppId": "yDwhxUUckp3gl8j5UuFX33LSNozpRsbi",
"ProxyOrganizationOpenId": "org_dianziqian",
"ProxyOperator": {
"OpenId": "n9527"
},
"ProxyAppId": ""
},
"SealName": "合同专用章",
"GenerateSource": "SealGenerateSourceSystem",
"SealType": "FINANCE",
"SealHorizontalText": "印章横向文字在这里"
}
输出示例
{
"Response": {
"SealId": "yDwi8UUckpo5z4omUyleFeZeadKwB=1Hm",
"ImageUrl": "https://file.test.ess.tencent.cn/bresource/resource/resource/0/0.PNG?hkey=a6c****66264",
"RequestId": "477f4d46-062c-4d72-a2e0-94e5b52b0cc5"
}
}
示例2 通过图片创建电子印章
1.SealImage传递图片的base64编码, GenerateSource不设置 2. 通过图片创建电子印章，需要电子签人工审核
输入示例
POST / HTTP/1.1
Host: essbasic.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateSealByImage
<公共请求参数>
{
"Agent": {
"AppId": "yDwhxUUckp3gl8j5UuFX33LSNozpRsbi",
"ProxyOrganizationOpenId": "org_dianziqian",
"ProxyOperator": {
"OpenId": "n9527"
},
"ProxyAppId": ""
},
"SealName": "人事专用章",
"SealImage": "iVBORw0KGgoAAAANSUhEUgAAAGwAAABuCAYAAADCrvbGAAABW2lDZXE15yz3uZ6TErkJggg....(图片base64省略)",
"SealType": "PERSONNEL"
}
输出示例
{
"Response": {
"SealId": "yDwi8UUckpo5z4k1UyleFeZEcAE49vb6",
"ImageUrl": "",
"RequestId": "62378bbc-2384-499c-89f6-7835040b24a1"
}
}
5. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| AuthFailure | CAM签名/鉴权错误。 |
| FailedOperation | 操作失败。 |
| FailedOperation.AuthFail | 鉴权失败。 |
| FailedOperation.ExistSameSealName | 存在同名印章。 |
| InternalError.SealUpload | 上传印章失败。 |
| InternalError.System | 系统错误。 |
| InvalidParameter.Image | 图片不正确。 |
| InvalidParameter.LimitSealName | 印章名称长度超出。 |
| InvalidParameter.ParamError | 参数错误。 |
| InvalidParameter.SensitiveFileContent | 文件内容敏感信息。 |
| MissingParameter.OrganizationId | 企业信息为空。 |
| MissingParameter.SealImage | 印章图片为空。 |
| MissingParameter.SealName | 印章名称为空。 |
| OperationDenied | 操作被拒绝。 |
| OperationDenied.AlreadyHas | 相关资源已经存证, 无法在创建新的相关资源 |
| ResourceNotFound.Organization | 机构不存在。 |
| ResourceNotFound.VerifyUser | 实名用户信息不存在。 |
| UnauthorizedOperation.NoPermissionFeature | 请升级到对应版本后即可使用该接口。 |