接口描述
根据传入的姓名,印章类型、颜色等信息,生成个人用户的印章Base64数据,用于后续签署传入。
接口名称
新版推荐(仅限3.0.7及以上版本支持):
TemplateSealService.createPsnSeal(String accountId,String name,PersonTemplateType type,SealColor color, StampRuleEnum stampRule)
旧版不推荐(方法名不一致,且没有accountId字段):
TemplateSealService.createPersonalSeal(String name,PersonTemplateType type,SealColor color, StampRuleEnum stampRule)
请求参数
参数名称 | 类型 | 必选 | 参数说明 | ||
accountId | String | 否 | 个人账号ID(创建个人签署账号接口返回)
| ||
name | String | 否 | 用户姓名(待创建印章的内容文本)
| ||
type | PersonTemplateType | 是 | 印章模板类型 | ||
类型名 | 类型说明 | 印章示例 | |||
SQUARE | 正方形印章 | ![]() | |||
RECTANGLE | 矩形印章 | ![]() | |||
BORDERLESS | 无框矩形印章 | ![]() | |||
color | SealColor | 是 | 生成印章的颜色 枚举: (1)RED,红色 (2)BLUE,蓝色 (3)BLACK,黑色 | ||
stampRule | StampRuleEnum | 是 | 印章是否加“印”规则 SEAL_NONE,无‘印’ |
响应参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 | |
addSealResult(点击“+”展开详情) | AddSealResult | 是 | 响应结果类 | |
errCode | int | 是 | 错误码,0标识成功,其他均标识失败 | |
msg | String | 否 | 错误信息,错误码对应的说明信息 | |
errorShow | boolean | 否 | 错误信息是否建议显示 | |
sealData | text | 否 | 最终生成的电子印章图片Base64数据 |
请求示例
//获取客户端的代码:
ServiceClient getKHD = ServiceClientManager.get("您的pojectId");
TemplateSealService templateSealService = getKHD.templateSealService();
String accountId = "";////个人账号ID(创建个人签署账号接口返回),与name必须二选一传值
String name = "张三";// 用户姓名(待创建印章的内容文本),与accountId必须二选一传值
PersonTemplateType type = PersonTemplateType.BORDERLESS; // 印章模板类型,可选:SQUARE-正方形印章 | RECTANGLE-矩形印章 | BORDERLESS-无框矩形印章
SealColor color = SealColor.RED;// 印章颜色:RED-红色 | BLUE-蓝色 | BLACK-黑色
StampRuleEnum stampRule = StampRuleEnum.SEAL_NONE;//印章是否加“印”规则:SEAL_NONE,无‘印’| SEAL_ONE,带‘印’| SEAL_TWO,带‘之印’
AddSealResult addSealResult = templateSealService.createPsnSeal(accountId,name,type,color,stampRule);
if (addSealResult.getErrCode() != 0)
System.out.println("创建个人模板印章失败:" + JSONObject.fromObject(addSealResult));
else
System.out.println("创建个人模板印章成功," + JSONObject.fromObject(addSealResult));
响应示例
{
"errCode":0,
"errShow":false,
"msg":"成功",
"sealData":"iVBORw0KGgoAAAANSUhEUgAAAP8AAAD/CAMAAAAJ1vD4AAADAFBMVEX/////AAAAAP8AAAgh/aU4E/O30v49/r+1PzdhP8uf9H899KmVP1Ek87t/4cLePyz3Db3Sfmnfu7C2esT8kd/64oZ560ZlqeN42tq6vzS/Leds5Z5tDqOVN4V+fPXcI8V4JXqdJuivcku1fGukLfm90QNPRzqZ4jMYdhKx/PjJ1q5EXw3gLJHVua3ffhdj9yxX19euZ0y35y/U+mgoMDNKWdDMTXMvqpGUOjerKyuHd4ZVa3/yVt/a25Ye3Rn3DbEr1hVnTH5q/IrusxbYxE8XINX32yZWRXYgFT2/bWe/+bvAc/3PJ64iKvyK96finShBm92nnwt0naPGtWOXE22bTut/kvrgYaed3wr6v8TYs+/SnVJd2pgb+4XX3bpvHHpcD7eXXcW3YzdoI43CAuN+7XSE96/Mig3fmT+O7cGu15AVK9/Kutml6UvWf/lrU25Vlor6DHt+tcoX2XUKqee2r+eaOvPfbX4kfz69d4vqRG0P34gxfqM8cSVHa7MWMNd/PnH1fV4l+ef6ez+hPwuH4DtGqGGv6nkQtLzW2XxK5aeltKhPx8JrSd/nk/vpYHvPfnd/4ODQ8f7pljLKCPrkKc3ry+R/J5+xVq9nC6Nmoz3H4/dv3GDlNANCetfbeCj0ZY0BFtifJekf3ZnzSup5VXQpemLHgVb9thXevzOQUmfm7/0fLcGPhx606Ze1e6Xj+/KdlzofyWldODimqtmZ5i0pPRObUINPgJ7uZfuJ8aPVjrz/1S1qWodnUHNPXuvwcfA10cBXk+UNjeRnh7jPSl+yhLVcodmcvyptlHkfUnO+4+apa/zpDVQqnpNk5n/8HW+19L333+5X6AGe6ht730Fd1QDiTSyJCbndz/N1BGRxfiR5akV9374vEoo/rz73sEfvLA68X1i/l3x60odH/9WRXpPx89t83j/22VDwslDrvObqfN/Qw8eK4eX9Oq27+USV/Lv3iI/f+CZLtEbK/t/L2p9/dTAd8PnQE49tOoNhfh2fv5b6GxPQkHePlkTqwYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAPCW/gC1jd/QcslDSAAAAABJRU5ErkJggg=="
}