核验签署文件签章有效性

更新时间：2022-01-24 10:31:05

文档变更

2022年时，PDF文件验签变为核验签署文件签章有效性，以便开发者更容易理解，仅中文名称变更，其功能保持不变。

接口描述

如果针对本地保存的签署文件进行验签，则通过【上传本地文件】接口上传文件，获取fileid，再传入文件id，进行验签；如果是针对某一签署流程对应的某一签署后的文件进行验签，则可直接传入签署流程id+文件id，直接进行验签。

接口地址&请求方式

接口地址：/v1/documents/{fileId}/verify

请求方式：GET

请求头格式

具体请求头格式结构，请点击查看公共参数说明。

请求参数

参数名称

类型

必选

参数类型

参数说明

（左右拖动查看完整描述）

fileId

string

是

path

文件ID,该参数需放在请求地址上，可参考请求示例

flowId

string

否

query

签署流程ID，验签前请先完结签署流程

响应参数

展开全部参数参数名称				类型	必选	参数说明（左右拖动查看完整描述）
code				int	是	业务码，0表示成功
message				string	否	业务信息
data				object	否	业务数据
	signInfos			List	否
	cert		Object	否	证书信息
		owner	String	否	所有者
		serial	String	否	序列号
startDate		String	否	有效期开始时间
endDate		String	否	有效期结束时间
issuerCN		String	否	发布者名称
signature		Object	否	签名数据
	modify	boolean	否	是否篡改
	timeFrom	String	否	签署时间来源
	signDate	String	否	签署时间
sealData		String	否	印章数据

请求示例

GET https://smlopenapi.esign.cn/v1/documents/f34a02f8a04b415e8e5a0d5a2/verify?flowId=6cca7a040d1a6bdff5ea9cc60a7

响应示例

{
    "code": 0,
    "message": "成功",
    "data": {
    "signInfos": [
        {
                "sealData": "iVBORw0KGgoAAAAN***2dSW7DMBAE/f9PM9ccLIvT7Blu1UCAIHIkWSxztkby+SCEEEIIIYQQQgghhBBCCCGEEEIIIYQQQm4119d/ffvZt+P/X9Nz3rdz/bqXp3ONHv9178IXgAAIgEiA9Cx2ZHEAxAyIIvX3lUWJQBWB2AmIKgABkLMAUR6yuv06AcmAXAVEhHV9QCKfxMjDBRAAARAAiS2aWpoq1Yr7usprAQRAAARAAGRKDpK1UKOltrNkBhAAAZCsPkg2IGr1AiALdlJHpZbXSr4S2RFptQPIvYBkT3OzX1t5rZHQxLg/aSEieRCAAAiAlNCxkLKaX45ZS+EzABAAARAAORkQNc46TULODq9yL+4SPwA5gADIpoCoU1XF8JMBUGQho+FsNHS9nfcoQBxdyNmAZJXXam4EIAByJiDquH50LK8ulOt4taFoiyoGQAAEQITkGUBMo3I1h8goR53nzTJFbTuLARAA2RKQCCTu80be11GAOON3RUmr5AUV3V6jZxVAAGTzEONoMjkBqDQyqTC6PKvXAVLxSQcQAAGQHWYxkQfiHOcr434HYNml9BGdVAABEAAR+y1XAJI13nbOWrIabdnWgeP6IAACIOEqxt0TGWltR+17LqOTY5obAP4sQNwei9F8x3VczakABEAAJBLvncYcRy7hyhUqcrLjDEPZ1j4AuRAQdpADAcmExdW0UktiZwOPJBVAAOQmQNwjgCsAyUpCnZ9qJRfI6o6qDrsAbAACIBv+CSrHomX5QUfDherGr7zWFeN+ABnf2QAEQPYFZNJ425ajuBfdqWPH/QACIAACIDFHWbVZxpnvjC7ULPPQVp5UAAGQYUBmyN3qdjXazO9x305qxq5Q4SPJMkUlQQ4gAHLRLKby4TomzgpAzrnNddNcAAEQALkZkKxGWYYRKQKhY36SYWTquC8AARAAmQKI6j8FkGCjzLForo6ns1zNOpfZ0gAgALIRIKNvqHLSGYVqxBPrME293dd2VczugDiS1NGczGCABhAA2dwPUpHhV/pQ3SEiOUcBkBUAcTjdrgUk+iAB5GBAss09FY6yAp9o2v+Z2b6TCiAAsjUgFdXT1YBkxddsF5ljcZyAjNobAARAzhnWVTSOspzmldXX6MQaQAAEQADkQkDUcf9oTHbmI9WvNdojAARAAGQ6IJEwlw1I8Bx3ABJZ9FHYnHlBVj4SyL0ABEAAJGVyOyusqC5/MRwCyAqAOHyvAAIgAJLVKFO2dQeMznxmtBJjFgMgAAIgADL133ao8V29hjMHGYV8u0YZgAAIQgjtp3b49VDRgkVj9NOxp3jegGtdQCKJWev4/gmG9rLQreOe0CQwej6xrROWJxiasBsAxSIhpnUC0joW/9t5f+0IrWO3AZQNQkzPokd2qJ7wRYhZAIzeBWuBcPJ5+d3WGbKAYuEqphmSyPYDkA+AnAdIT1LbXnaN6E6DFklSozlID2wtkBi/AQIsC+cgPed62xGizTV6IQghhBBCCFXoD9GuzoVfBl6eAAAAAElFTkSuQmCC",
                "cert": {
                    "owner": "杭州天谷有限公司",
                    "serial": "536deb6bfce98a9143f143ca",
                    "startDate": "2020-04-13 11:46:18",
                    "endDate": "2021-04-13 11:46:18",
                    "issuerCN": "智慧CA_测试CA"
                },
                "signature": {
                    "modify": false,
                    "timeFrom": "tsa",
                    "signDate": "2021-01-14 17:03:43"
                }
            }
    ]
    }
}

错误码

错误码

错误描述

排查方法

（左右拖动查看完整描述）

1435002

参数错误: flowId和fileId不匹配

流程下没有相应的文档