获取创建法定代表人印章页面链接

更新时间:2024-09-24 11:47:39

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

设置页面中不可编辑的字段,可选值如下:

  • sealCreateMode - 制章方式
  • sealName - 印章名称
  • sealSuffix - 印章后缀格式
  • sealTemplateStyle - 印章模板样式
  • sealSize - 印章尺寸
  • sealColor - 印章颜色
  • sealOpacity - 印章不透明度

响应参数

展开全部参数参数名称

参数类型

必选

参数说明

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"
    }
}

错误码

点击查看错误码