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