必须确保企业用户已授予平台appId获取其印章资源管理的权限,点击查看如何授权
- manage_org_seal - 授权允许获取企业/组织用户的印章的查询、新增、编辑、授权、删除权限
接口描述
提供可视化的页面(免登录),由机构经办人选择印章的样式、内容等,来创建机构的法定代表人印章。
- 开发者可预设置印章的样式等其他参数,若不指定则可由经办人在页面中选择。
- 接口用于获取制作印章的页面地址,支持开发者将地址集成到内部系统当中访问。
- 通过页面印章创建成功后,系统将会向开发者推送【创建印章通知】。
接口地址&请求方法
接口地址:https://{host}/v3/seals/legal-rep-seal-create-url
请求方法:POST
请求头格式
具体请求头参数,请查看公共请求头格式。
请求参数
参数名称 | 参数类型 | 必选 | 参数位置 | 参数说明 |
orgId | string | 是 | body | 机构账号ID 【注】账号ID获取方式请使用【查询机构认证信息】接口通过组织机构名称/组织机构证件号进行查询 |
transactorPsnId | string | 是 | body | 经办人个人账号ID 【注】建议由法定代表人本人操作,否则其他人需要在页面里给法定代表人发送授权书,签署通过后才可以完成印章创建(点击跳转【查询企业成员列表】接口) |
customBizNum | string | 否 | body | 自定义业务编号 【注】接口不对该参数的值做重复性校验。(用于关联开发者的业务系统,印章创建成功后将通过创建印章回调通知和印章编号一同返回) |
sealName | string | 否 | body | 法定代表人印章名称(由用户自定义,且名称不可重复) |
sealCreateMode | string | 否 | body | 指定制章方式 template - 按照模板制作印章 file - 上传本地图片制作印章 |
sealTemplateStyle | string | 否 | body | 指定页面机构模板印章样式 RECTANGLE_NO_BORDER- 不带边框长方形章 RECTANGLE_BORDER- 带边框长方形章 SQUARE_LEFT_BORDER- 带边框正方形章(左侧字体放大) SQUARE_RIGHT_BORDER- 带边框正方形章(右侧字体放大) SQUARE_LEFT_NO_BORDER- 不带边框正方形章(左侧字体放大) SQUARE_RIGHT_NO_BORDER- 不带边框正方形章(右侧字体放大) |
sealSize | string | 否 | body | 机构印章尺寸(单位:毫米mm,格式:宽_高)
长方矩形章固定值:20_10 正方形章固定值:20_20、18_18、16_16 |
sealColor | string | 否 | body | 机构印章颜色 RED -红色,BLUE -蓝色,BLACK -黑色,PURPLE -紫色 |
sealOpacity | int32 | 否 | body | 印章不透明度(默认值为80) 取值范围 【20-100】(100表示不透明) |
redirectUrl | string | 是 | body | 重定向地址 创建成功后跳转到的页面地址,满足https地址协议,不可超过1024个字符 |
uneditableFields | list | 否 | body | 设置页面中不可编辑的字段,可选值如下:
|
响应参数
展开全部参数参数名称 | 参数类型 | 必选 | 参数说明 | ||||
code | int32 | 是 | 业务码,0表示成功,非0表示异常。 | ||||
message | string | 否 | 业务信息 请根据 code 来判断错误情况,不应该依赖message匹配,因为 message 可能会调整。 | ||||
data(点击“+”展开详情) | object | 否 | 业务数据 | ||||
legalRepSealCreateUrl | string | 否 | 创建机构法定代表人印章页面链接(有效期30分钟,过期需要重新获取) |
请求示例
{
"orgId":"0c5bd492***48bfbf",
"transactorPsnId": "c7e00294***10541e7",
"customBizNum": "这是一串开发者内部系统自定义的编号",
"sealName": "这是个预定义的企业印章名称",
"sealColor": "RED",
"redirectUrl":"http://www.xxx.cn/",
"uneditableFields":["sealName","sealColor"]
}
响应示例
{
"message": "成功",
"code": 0,
"data": {
"legalRepSealCreateUrl": "https://h5.esign.cn/auth/guide?loginId=xx-xx-xx-xx-xx"
}
}