Kiểm tra chữ ký số PDF API

Kiểm tra mọi chữ ký số trong file PDF: toàn vẹn, sửa sau khi ký, người ký (MST, CCCD), thời điểm ký, dấu thời gian và chuỗi tới Root CA quốc gia.

Tham số

Ví dụ

curl -X POST "https://apibox.io.vn/v1/pdf-sign-verify" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "0=@./my-file"

const form = new FormData();
form.append('0', fileInput.files[0]);

const res = await fetch('https://apibox.io.vn/v1/pdf-sign-verify', {
  method: 'POST',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
  body: form,
});
console.log(await res.json());

import requests

res = requests.post(
    "https://apibox.io.vn/v1/pdf-sign-verify",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    files={"0": open("my-file", "rb")},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/pdf-sign-verify');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => ['0' => new CURLFile('my-file')],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Kết quả trả về

{
  "signed": true,
  "signature_count": 1,
  "timestamp_count": 0,
  "all_valid": true,
  "all_trusted": true,
  "document_unchanged_since_last_signature": true,
  "has_ltv_data": false,
  "file_size": 222785,
  "signatures": [
    {
      "index": 1,
      "type": "signature",
      "sub_filter": "adbe.pkcs7.detached",
      "reason": "CHÍNH PHỦ<cp@chinhphu.vn> đã ký lên văn bản này!",
      "location": "Hà Nội",
      "claimed_signing_time": "2026-11-10T07:20:38.000Z",
      "covers_whole_file": true,
      "modified_after_signing": false,
      "integrity_valid": true,
      "signature_valid": true,
      "digest_algorithm": "SHA-256",
      "signing_time": "2026-11-10T07:20:39.000Z",
      "signing_time_source": "timestamp",
      "timestamp": {
        "time": "2026-11-10T07:20:39.000Z",
        "tsa": "Máy chủ cấp dấu thời gian CPNET",
        "serial_number": "42198483DA95DD67",
        "imprint_valid": true,
        "signature_valid": true
      },
      "certificate": {
        "common_name": "CHÍNH PHỦ",
        "organization": "CHÍNH PHỦ",
        "tax_code": null,
        "citizen_id": null,
        "issuer_common_name": "CA phục vụ các cơ quan Nhà nước G2",
        "serial_number": "75E92DD9AD56BD4D",
        "not_before": "2025-11-04T07:09:12.000Z",
        "not_after": "2030-11-03T07:09:12.000Z",
        "valid_at_signing": true,
        "expired": false,
        "key": {
          "algorithm": "RSA",
          "bits": 3072
        },
        "revocation_urls": {
          "crl": [
            "http://ca.gov.vn/pki/pub/crl/cpcag2.crl"
          ],
          "ocsp": [
            "http://ocsp.ca.gov.vn"
          ],
          "ca_issuers": [
            "http://ca.gov.vn/pki/pub/crt/cpcag2.crt"
          ]
        }
      },
      "chain": [
        {
          "subject": "CHÍNH PHỦ",
          "issuer": "CA phục vụ các cơ quan Nhà nước G2",
          "signature_verified_by_issuer": true,
          "in_ca_list": false,
          "trust_anchor": false
        },
        {
          "subject": "CA phục vụ các cơ quan Nhà nước G2",
          "issuer": "RootCA chuyên dùng Chính phủ G2",
          "signature_verified_by_issuer": true,
          "in_ca_list": true,
          "trust_anchor": false,
          "ca": "ban-co-yeu-chinh-phu"
        },
        {
          "subject": "RootCA chuyên dùng Chính phủ G2",
          "issuer": "RootCA chuyên dùng Chính phủ G2",
          "signature_verified_by_issuer": true,
          "in_ca_list": true,
          "trust_anchor": true,
          "ca": "ban-co-yeu-chinh-phu"
        }
      ],
      "chain_complete": true,
      "trusted_root": true,
      "trusted_root_name": "RootCA chuyên dùng Chính phủ G2",
      "certificates_valid_at_signing": true,
      "valid": true
    }
  ],
  "revocation_checked": false
}

Ứng dụng

• Kiểm tra hợp đồng, hồ sơ khách hàng đã ký số trước khi tiếp nhận
• Phát hiện file PDF bị sửa sau khi ký trong quy trình phê duyệt
• Lấy mã số thuế người ký và thông tin chứng thư để lưu hồ sơ
• Kiểm tra văn bản tải về từ cổng thông tin cơ quan nhà nước

Hỏi đáp

API liên quan