获取签署流程中的印章图片

更新时间:2022-01-24 03:25:21

接口描述

通过签署流程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
                    }
                ]
            }
        ]
    }
}
我要纠错