创建机构图片印章

更新时间:2024-09-24 11:44:01

必须确保企业用户已授予平台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"
    }
}

错误码

点击查看错误码

我要纠错