创建个人图片印章

更新时间:2025-02-12 10:10:36

必须确保个人用户已授予平台appId获取其印章资源管理权限,点击查看如何授权

  • manage_psn_resource - 授权允许获取个人用户的印章等资源的管理权限

接口描述

上传本地印章图片来创建个人印章。

  • 图片印章的初始状态为“待审核”,创建成功后需经过e签宝AI校验审核或人工审核(1-2个工作日),审核通过后状态变更为“已启用”,用户也可在印章管理列表页中查看印章。
  • 印章创建成功,e签宝将会向开发者推送【创建印章通知】
  • 开发者可通过接收【图片印章审核结果通知】获取审核的结果。

接口地址&请求方法

接口地址:https://{host}/v3/seals/psn-seals/create-by-image

请求方法:POST

请求头格式

具体请求头参数,请查看公共请求头格式

请求参数

参数名称

参数类型

必选

参数位置

参数说明

psnId

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-紫色

manualAudit

boolean

body

是否需要不经过AI直接走e签宝人工审核(人工审核需要上传印章备案材料),默认false

true - 是

false - 否

【注】当传true时,下方sealFilingMaterials必须传入

sealFilingMaterials

list

body

印章备案材料fileKey,此参数值在上传印章图片接口进行图片上传后获取。

【注】

(1)支持jpg/jpeg/png/bmp/doc/pdf格式的文件

(2)文件大小不超过2M

响应参数

展开全部参数参数名称

参数类型

必选

参数说明

code

int32

业务码,0表示成功,非0表示异常。

message

string

业务信息

请根据 code 来判断错误情况,不应该依赖message 匹配,因为 message 可能会调整。

data(点击“+”展开详情)

object

业务数据

sealId

string

印章ID(建议开发者本地保存印章编号)

请求示例

{
  "psnId": "c7e0029***0541e7",
  "sealImageFileKey": "$c3c7170e-xx-xx-xx-xx",
  "sealName": "这是一个自定义的印章名称",
  "sealWidth": "20",
  "sealHeight": "10",
  "sealColor": "RED"
}

响应示例

{
    "message": "成功",
    "code": 0,
    "data": {
        "sealId": "6de1900f-xx-xx-xx-f3292b7b6599"
    }
}

错误码

点击查看错误码

我要纠错