接口说明
传入pdf文件,在线验证签名是否被篡改,文件是否真实有效
API 方法名:nuonuo.eleConShortcutSign.verify 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| application | String | 否 | - | 应用名称,由电子合同快捷签系统分配 | 91320506714110607W_api_test |
| contractNo | String | 是 | - | 合同编号或base64合同文件传一个 | 2020112010080233688465631 |
| base64File | String | 是 | - | 合同文件base64编码(仅支持pdf) | - |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | 成功标识 | H200 |
| describe | String | 否 | - | 描述 | 成功 |
| result | Object | 否 | - | 结果信息明细 | - |
| └ validSignature | Number | 否 | - | 有效签名个数 | 13 |
| └ invalidSignature | Number | 否 | - | 无效签名个数 | 0 |
| └ verifyPdfResponseList | Array | 否 | - | 验签结果数据 | - |
| └ code | Number | 否 | - | 校验结果代码 0:校验成功 1:校验失败 | 0 |
| └ message | String | 否 | - | 校验结果描述 | 自应用本签名以来,“文档”未被修改 |
| └ signatory | String | 否 | - | 签署人 | 张三 |
| └ signTime | String | 否 | - | 签署时间 | 2021-02-19 14:49:31 |
| └ organization | String | 否 | - | 颁布机构 | CWCA |
| └ hasTimeStamp | String | 否 | - | 是否包含时间戳 true是,false否 | false |
| └ timeStampMessage | String | 否 | - | 包含时间戳信息 | 签名不包含嵌入的时间戳 |
| └ certDateStart | String | 否 | - | 证书有效期开始时间 | 2021-02-19 14:21:16 |
| └ certDateEnd | String | 否 | - | 证书有效期结束时间 | 2022-02-19 14:21:16 |
| └ imgBase64String | String | 否 | - | 签署印章图片base64 | - |
| └ pdfStatus | String | 否 | - | pdf是否被篡改,false 未被篡改,true被篡改 | false |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.eleConShortcutSign.verify"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"base64File\": \"\",
\"application\": \"91320506714110607W_api_test\",
\"contractNo\": \"2020112010080233688465631\"
}";
String url = "https://sdk.nuonuo.com/open/v1/services"; // SDK请求地址
String senid = UUID.randomUUID().toString().replace("-", ""); // 唯一标识,32位随机码,无需修改,保持默认即可
String result = sdk.sendPostSyncRequest(url, senid, appKey, appSecret, token, taxnum, method, content);
System.out.println(result);
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
H200 | 成功 | |
H10105 | 权限不足 | |
H88888 | 参数异常 | |