接口描述
传入待签文本原文、文本签署后的签名结果，验证文本是否被篡改、加密数字证书信息。
接口
/v1/dataSign/verify
请求方式
POST
请求头
提供两种安全接入方式，开发者可选择其中一种方式进行对接，对应参数如何获取，参考文档【请点击】。
方式一：请求签名鉴权
请求头入参示例如下：
参数名称 | 类型 | 必选 | 参数说明 | 示例值 |
X-Tsign-Open-App-Id | string | 是 | 项目ID | |
Content-Type | string | 是 | application/json;charset=UTF-8 | |
X-Tsign-Open-Ca-Timestamp | string | 是 | API 调用者传递时间戳，值为当前时间的毫秒数，也就是从1970年1月1日起至今的时间转换为毫秒，时间戳有效时间为15分钟，为了防重放攻击 | |
Accept | string | 是 | 建议统一填写 */* | |
X-Tsign-Open-Ca-Signature | string | 是 | 签名字符串 | |
Content-MD5 | string | 否 | 当请求 Body 非 Form 表单时，可以计算 Body 的 MD5 值传递给云网关进行 Body MD5 校验。建议当请求 Body 非 Form 表单时，加上此请求头。 | |
X-Tsign-Open-Auth-Mode | string | 是 | 选择请求方式进行鉴权，固定值，Signature |
方式二：OAuth2.0鉴权
当安全接入选择OAuth2.0鉴权方式，请点击查阅详情，请求头入参示例如下：
参数名称 | 类型 | 必选 | 参数说明 |
X-Tsign-Open-App-Id | string | 是 | 项目ID |
X-Tsign-Open-Token | string | 是 | 通过获取鉴权Token接口返回 |
Content-Type | string | 是 | application/json; charset=UTF-8 |
请求参数
参数名称 | 类型 | 必选 | 参数类型 | 参数说明 | 示例值 |
data | text | 是 | body | 文本签原文 | |
signResult | text | 是 | body | 文本签返回的签署结果 |
公共响应参数
参数名称 | 类型 | 必选 | 参数说明 | 示例值 |
code | int | 是 | 业务码，0表示成功 | |
message | string | 否 | 信息 | |
data | object | 否 | 业务信息 |
响应参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 | 示例值 | ||
signInfo | Object | 否 | ||||
cert | Object | 否 | 证书信息 | |||
owner | string | 否 | 所有者 | |||
serial | string | 否 | 序列号 | |||
startDate | string | 否 | 有效期开始时间 | |||
endDate | string | 否 | 有效期结束时间 | |||
issuerCN | string | 否 | 发布者名称 | |||
signature | Object | 否 | 签名数据 | |||
modify | string | 否 | 是否篡改 | |||
请求示例
POST https://smlopenapi.esign.cn/v1/dataSign/verify
{
"data": "测试测试",
"signResult": "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"
}响应示例
{
"code": 0,
"message": "成功",
"data": {
"signInfo": {
"cert": {
"owner": "杭州天谷信息科技有限公司（对接专用）",
"serial": "6bdea579b491bxxxxxxx",
"startDate": "2019-11-18 20:30:41",
"endDate": "2020-11-18 20:30:41",
"issuerCN": ""
},
"signature": {
"modify": false
}
}
}
}错误码
错误码 | 错误描述 | 解决方案 |
1438401 | 验签失败 | 验签失败 |
我要纠错