获取创建机构印章页面链接

更新时间:2024-09-24 11:48:25

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

  • manage_org_seal - 授权允许获取企业/组织用户的印章的查询、新增、编辑、授权、删除权限

接口描述

提供可视化的页面(免登录),由机构经办人选择印章的样式、内容等,来创建机构印章。

  • 开发者可预设置机构印章的样式等其他参数,若不指定则可由用户在页面中选择。
  • 接口用于获取制作机构印章的页面地址,支持开发者将地址集成到内部系统当中访问。
  • 通过页面印章创建成功后,e签宝将会向开发者推送【创建印章通知】

接口地址&请求方法

接口地址:https://{host}/v3/seals/org-seal-create-url

请求方法:POST

请求头格式

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

请求参数

参数名称

参数类型

必选

参数位置

参数说明

orgId

string

body

机构账号ID

【注】用户在e签宝注册实名后才有账号ID,账号ID获取方式请使用【查询机构认证信息】接口通过组织机构名称/组织机构证件号进行查询

transactorPsnId

string

body

经办人个人账号ID

【注】必须确保经办人在该机构的成员中,拥有印章管理权限。建议直接由法定代表人或者管理员来操作(点击跳转【查询企业成员列表】接口

customBizNum

string

body

自定义业务编号

【注】接口不对该参数的值做重复性校验。

(用于关联开发者的业务系统,印章创建成功后将通过创建印章回调通知和印章编号一同返回)

sealName

string

body

机构印章名称(由用户自定义,且名称不可重复)

sealCreateMode

string

body

指定制章方式

template - 按照模板制作印章

file - 上传本地图片制作印章

sealTemplateStyle

string

body

指定页面机构模板印章样式

PUBLIC_ROUND_STAR - 圆形公章(带五角星)

PUBLIC_OVAL - 椭圆形公章(不带五角星)

PUBLIC_TWO_OVAL - 双椭圆形公章(不带五角星)

CONTRACT_ROUND_NO_STAR - 合同专用章(圆形章,不带五角星)

CONTRACT_ROUND_STAR - 合同专用章(圆形章,带五角星)

PERSONNEL_ROUND_NO_STAR - 人事专用章(圆形章,不带五角星)

PERSONNEL_ROUND_STAR - 人事专用章(圆形章,带五角星)

FINANCE_ROUND_NO_STAR - 财务专用章(圆形章,不带五角星)

FINANCE_ROUND_STAR - 财务专用章(圆形章,带五角星)

FINANCE_SQUARE_HORIZONTAL - 财务专用章(横排正方形章,不带五角星)

FINANCE_SQUARE_VERTICAL - 财务专用章(竖排正方形章,不带五角星)

COMMON_ROUND_STAR - 其他章(圆形章,带五角星)

COMMON_OVAL - 其他章(椭圆章)

COMMON_TWO_OVAL - 其他章(双椭圆章)

sealSize

string

body

机构印章尺寸(单位:毫米mm,格式:宽_高)

  • 请依据指定的模板印章样式传入对应的印章尺寸:

PUBLIC_ROUND_STAR 样式固定尺寸:42_42、40_40

PUBLIC_OVAL 样式固定尺寸:45_30

PUBLIC_TWO_OVAL 样式固定尺寸: 45_30

CONTRACT_ROUND_NO_STAR 样式固定尺寸:38_38

CONTRACT_ROUND_STAR 样式固定尺寸:38_38

PERSONNEL_ROUND_NO_STAR 样式固定尺寸: 38_38

PERSONNEL_ROUND_STAR 样式固定尺寸: 38_38

FINANCE_ROUND_NO_STAR 样式固定尺寸: 38_38

FINANCE_ROUND_STAR 样式固定尺寸: 38_38

FINANCE_SQUARE_HORIZONTAL 样式固定尺寸: 22_22

FINANCE_SQUARE_VERTICAL 样式固定尺寸:22_22

COMMON_ROUND_STAR 样式固定尺寸:42_42、40_40

COMMON_OVAL 样式固定尺寸:45_30

COMMON_TWO_OVAL 样式固定尺寸:45_30

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

业务数据


orgSealCreateUrl

string

创建机构印章页面链接(有效期30分钟,过期需要重新获取)

请求示例

{
    "orgId":"0c5bd492***48bfbf",
    "transactorPsnId": "c7e00294***10541e7",
    "customBizNum": "这是一串开发者内部系统自定义的编号",
    "sealName": "这是个预定义的企业印章名称",
    "sealColor": "RED",
    "redirectUrl":"http://www.xxx.cn/",
    "uneditableFields":["sealName","sealColor"]
}

响应示例

{
    "message": "成功",
    "code": 0,
    "data": {
        "orgSealCreateUrl": "https://h5.esign.cn/auth/guide?loginId=xx-xx-xx-xx-xx"
    }
}

错误码

点击查看错误码

我要纠错