必须确保企业用户已授予平台appId获取其印章资源管理权限,点击查看如何授权
- manage_org_seal - 授权允许获取企业/组织用户的印章的查询、新增、编辑、授权、删除权限
接口描述
上传本地印章图片来创建机构印章。
- 图片印章的初始状态为“待审核”,创建成功后需经过e签宝人工审核(1-2个工作日),审核通过后状态变更为“已启用”,用户也可在印章管理列表页中查看印章。
- 印章创建成功,e签宝将会向开发者推送【创建印章通知】。
- 开发者可通过接收【图片印章审核结果通知】获取审核的结果。
接口地址&请求方法
接口地址:https://{host}/v3/seals/org-seals/create-by-image
请求方法:POST
请求头格式
具体请求头参数,请查看公共请求头格式。
请求参数
参数名称 | 参数类型 | 必选 | 参数位置 | 参数说明 |
orgId | string | 是 | body | 机构账号ID 【注】用户在e签宝注册实名后才有账号ID,账号ID获取方式请使用【查询机构认证信息】接口通过组织机构名称/组织机构证件号进行查询 |
sealImageFileKey | string | 是 | body | 印章图片的fileKey,此参数值在上传印章图片时获取。 |
sealName | string | 是 | body | 印章名称(用户自定义,且名称不可重复) |
sealWidth | int32 | 是 | body | 印章宽度(单位:mm,上限为100mm) |
sealHeight | int32 | 是 | body | 印章高度(单位:mm,上限为100mm) |
sealColor | string | 否 | body | 印章颜色(默认值为 RED) RED - 红色,BLUE - 蓝色,BLACK - 黑色,PURPLE - 紫色 |
sealBizType | string | 否 | body | 印章业务类型 PUBLIC - 公章 CONTRACT - 合同专用章 PERSONNEL - 人事专用章 FINANCE - 财务专用章 COMMON - 其他 |
imageProcess | boolean | 否 | body | 是否需要对图片做背景处理(默认值 true) true - 需要处理(进行抠图和颜色绘制) false - 不需要处理(不进行抠图和颜色绘制) |
响应参数
展开全部参数参数名称 | 参数类型 | 必选 | 参数说明 | ||||
code | int32 | 是 | 业务码,0表示成功,非0表示异常。 | ||||
message | string | 否 | 业务信息 请根据 code 来判断错误情况,不应该依赖message 匹配,因为 message 可能会调整。 | ||||
data(点击“+”展开详情) | object | 否 | 业务数据 | ||||
sealId | string | 否 | 印章ID(开发者需妥善保存印章编号) |
请求示例
{
"orgId": "0c5bd492**48bfbf",
"sealImageFileKey": "$c3c7170e-xx-xx-xx-xx",
"sealName": "这是一个自定义的印章名称",
"sealWidth": "20",
"sealHeight": "10",
"sealBizType": "CONTRACT"
}
响应示例
{
"message": "成功",
"code": 0,
"data": {
"sealId": "6de1900f-xx-xx-xx-f3292b7b6599"
}
}