接口描述
通过签署流程flowId,查询当前流程中已签署完成的印章图片。返回的印章图片默认带有水印:仅供展示使用。
调用前提:
(1)若需使用此接口,请先联系e签宝的工作人员或交付顾问开通此功能;
(2)流程中的签署方需要完成认证授权后,才可通过此接口查询印章图片。
接口地址&请求方式
接口地址:/v3/sign-flow/{flowId}/preview-seal-image?signerId=xxx&signOrder=xx
请求方式:GET
请求头格式
具体请求头格式结构,请点击查看公共参数说明。
请求参数
参数名称 | 类型 | 必选 | 参数类型 | 参数说明 (左右拖动查看完整描述) |
flowId | string | 是 | path | 签署流程ID |
signerId | string | 否 | query | 签署方id(印章所属的主体个人或机构账号ID) |
signOrder | int32 | 否 | query | 签署顺序 |
响应参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 (左右拖动查看完整描述) | |||
code | int | 是 | 业务码,0表示成功 | |||
message | string | 是 | 信息 | |||
data | object | 否 | 业务信息 | |||
signInfos | array | 否 | 签署相关信息 | |||
operatorId | string | 否 | 操作人id | |||
signerId | string | 否 | 签署方id | |||
authorized | boolean | 否 | 是否已认证授权 | |||
signOrder | int32 | 否 | 签署顺序 | |||
watermarkSealInfos | array | 否 | 印章信息 | |||
sealImageDownloadUrl | string | 否 | 印章(加水印)图片下载地址 注:已认证授权为true的情况下才返回印章图片下载地址 | |||
sealStyle | int | 否 | 印章外观样式: 0-手绘,1-印章 |
请求示例
GET https://openapi.esign.cn/v3/sign-flow/21e14fxxx/preview-seal-image
响应示例
{ "code": 0, "message": "成功", "data": { "signInfos": [ { "operatorId": "0aa8640685874e65b17cbc202fxxx", "signerId": "0aa8640685874e65b17cbc202fxxx", "signOrder": 1, "authorized": true, "watermarkSealInfos": [ { "sealImageDownloadUrl": "https://esignoss.esign.cn/seal-service/f470a65f-aeb4-4abf-bf6e-5a67343d2a6d/xx-b9cc-44d6-94a5-cfa1d68817e6-openseal.png?Expires=1640694612&OSSAccessKeyId=xxx&Signature=B89pREjvxxW%2BlhNE%2FCVA29JFQzc%3D", //一个小时后失效 "sealStyle": 0 } ] }, { "operatorId": "8d2662e91ccd4ae7a6f1d6c1xxx", "signerId": "8d2662e91ccd4ae7a6f1d6c1xxx", "signOrder": 2, "authorized": false, "watermarkSealInfos": [ { "sealImageDownloadUrl": null, "sealStyle": 0 } ] } ] } }