4.5 使用文件ID验签

此接口使用签名后回调中的文件wsid进行验签。
验签状态值是FILE_INTEGRAL_CERT_VALID、FILE_INTEGRAL_ROOT_CERT_UNAUTHENTIC 可视为签名有效。其中 FILE_INTEGRAL_ROOT_CERT_UNAUTHENTIC 表示根证书不受信任，联系签名平台导入根证书即可。

请求参数

Authorization

Query 参数

access_token

string

必需

授权码；正式环境联系签署平台方获取

默认值:

3e9dec5f-4a9d-4af8-8abc-23e4675a1eb6

Header 参数

X-Signit-App-Id

string

必需

应用id；正式环境联系签署平台方获取

默认值:

1931fabdb516e66ca2f8c42691a

Body 参数application/json

files

array [object {1}]

必需

fileWsid

string

文件id

可选

回调中接收到的已签名文件的WSID

示例

{
  "files": [
    {
      "fileWsid": "WSID_FILE_000001967504d64da60e3bef263b44e5"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

string

接口响应码

必需

100900000 - 成功

message

string

接口响应消息

必需

verifiers

array [object {9}]

验签结果

必需

verifyStatus

string

验签状态

必需

NO_CERT_VALID - 无证书签名
FILE_INTEGRAL_CERT_VALID - 有证书签名，文件完整，证书可信
FILE_INTEGRAL_USER_CERT_INVALID - 有证书签名，文件完整，用户证书无效
FILE_INTEGRAL_ROOT_CERT_UNAUTHENTIC - 有证书签名，文件完整，根证书不可信
FILE_MODIFIED - 文件已被修改
FILE_UNSIGNED - 文件未被签名
FAILURE - 验证失败

verifyStatusLevel

string

验签状态级别

必需

INFO - 正常
WARN - 警告
ERROR - 错误

totalSignFields

integer

总共的签名域个数

必需

blankSignFields

integer

空白签名域个数

必需

signedFields

integer

已经签署的签名域个数

必需

validSignedFields

integer

有效的签名域个数

必需

verifyResults

array [object {2}]

可选

fileInfoResult

object

文件信息验证结果

必需

fileWsid

string

文件wsid

必需

示例

{
  "code": "100900000",
  "message": "操作成功",
  "verifiers": [
    {
      "verifyStatus": "FILE_INTEGRAL_CERT_VALID",
      "verifyStatusLevel": "INFO",
      "totalSignFields": 1,
      "blankSignFields": 0,
      "signedFields": 1,
      "validSignedFields": 1,
      "verifyResults": [
        {
          "signInfo": {
            "visible": true,
            "signFieldName": "Signature1",
            "signDatetime": 1745719973000,
            "signUser": "系统管理员@510***********2350",
            "signReason": "",
            "signLocation": "",
            "signContact": "",
            "totalSignRevisions": 1,
            "currentSignRevision": 1,
            "signCoveredWholeDoc": true,
            "modified": false,
            "position": {
              "ulx": 213.91,
              "uly": 285.84998,
              "lrx": 264.04,
              "lry": 310.06,
              "scale": 1
            },
            "page": 1,
            "ltv": true,
            "signAlgorithmName": "SM2",
            "signImageMd5": "bbaecd3fcb4649308453507217c311b3",
            "signDigestAlgorithmName": "SM3",
            "signDigestValue": "r0R/nBGivpr6pnmdMhz8hBgrs/SKNxArUBp4jLRGuUs=",
            "signValue": "MEYCIQD4I4utm8ljKrbyTKkE0VgcfgQBfHQBakFGunjAtvddOAIhAPFteN0Jlfoj5Z/lzc/MBBCVB2BOB7+I4haL/UsfXG7+",
            "signingValue": "MWkwGAYJKoZIhvcNAQkDMQsGCSqGSIb3DQEHATAcBgkqhkiG9w0BCQUxDxcNMjUwNDI3MDIxMjUwWjAvBgkqhkiG9w0BCQQxIgQgr0R/nBGivpr6pnmdMhz8hBgrs/SKNxArUBp4jLRGuUs="
          },
          "certInfo": {
            "certSubject": "C=CN,CN=系统管理员@510***********2350",
            "certIssuer": "C=CN,ST=陕西省,L=西安市,O=研发中心,CN=陕西CA证书测试系统三级业务根证书",
            "validStartDatetime": 1744168092000,
            "validEndDatetime": 1807240092000,
            "certAgainstRootValid": true,
            "certAgainstRootResult": "签名使用的数字证书是本签署平台信任的合法数字证书颁发机构签发",
            "certsChainLen": 1,
            "certInvalid": false,
            "certInvalidAt": -1,
            "tsaResult": {
              "timeStampEmbedded": true,
              "timeStampDate": 1745719973000,
              "verifyTimeStamp": true,
              "timeStampDigestAlgorithmName": "SHA256"
            },
            "ocspResult": {
              "ocspEmbedded": false,
              "verifyOCSP": false
            },
            "crlResult": {
              "crlEmbedded": false
            },
            "certSerialNumber": "2cf7065e24a1a6f",
            "certVersion": 3,
            "certSignAlgorithmName": "SM3WITHSM2",
            "certExtensions": [
              {
                "extnId": "2.5.29.31",
                "critical": false,
                "value": "BEkwRzBFoEOgQYY/aHR0cDovLzExNy4zMi4xMzIuNzQ6MzY5MDEvQ0E2MGQ4Yzg4NTU3MjQwNjM1MzdiMmNybC9zbTJjcmwuY3Js"
              },
              {
                "extnId": "2.5.29.35",
                "critical": false,
                "value": "BBgwFoAUYNjIhVckBjU3sqolYx2Kh4iSj78="
              },
              {
                "extnId": "2.5.29.14",
                "critical": false,
                "value": "BBYEFG7JT3dOckpiifF3Pvkub8XRuEBc"
              },
              {
                "extnId": "2.5.29.15",
                "critical": false,
                "value": "BAQDAgbA"
              }
            ]
          }
        }
      ],
      "fileInfoResult": {
        "fileName": "西药处方_李丽_20250427.PDF",
        "fileByteSize": 82295
      },
      "fileWsid": "WSID_FILE_000001967504d64da60e3bef263b44e5"
    }
  ]
}

🟠400参数不正确