KiemTraChuKy.vn
Developer Center

Tích hợp ký số
và xác thực

Tìm hiểu luồng ký số web và Local API của CertVN Desktop.

Web Signing

Ký số trên web với USB Token

Ứng dụng web gọi local service của CertVN Desktop trên máy người dùng. Desktop tương tác với USB Token và trả kết quả ký cho ứng dụng. Đây là khả năng cục bộ; Portal hiện không cung cấp endpoint ký số cloud công khai.

  1. 01

    Ứng dụng web chuẩn bị yêu cầu ký

  2. 02

    CertVN Desktop nhận yêu cầu qua local service

  3. 03

    USB Token thực hiện ký số trên máy

  4. 04

    Ứng dụng nhận kết quả và hoàn thành workflow

🔗 LOCAL API

Local API của CertVN Desktop

CertVN chạy REST API cục bộ chuẩn OpenAPI 3.0 — tích hợp trực tiếp vào ERP, DMS, hệ thống kế toán mà không cần cloud.

✍
Ký số cục bộ
Qua CertVN Desktop
🔒
Localhost only
An toàn, không qua cloud
📄
OpenAPI 3.0
Chuẩn hóa, dễ tích hợp
🔗
Swagger UI
Thử nghiệm trực tiếp
Request
terminal
curl -X POST http://localhost:6801 \
  -H "Content-Type: application/json" \
  -d '{
    "type": "pdf",
    "requestId": "req-001",
    "data": "<base64-encoded-pdf>",
    "certSerial": "4A1B2C3D",
    "page": 1,
    "x": 100,
    "y": 50
  }'
Response200 OK
response.json
{
  "status": "SUCCESS",
  "message": "Ký số thành công",
  "requestId": "req-001",
  "data": "<base64-signed-pdf>"
}
📖 Mở Swagger UI

Swagger docs đầy đủ tại localhost:6801/swagger (khi CertVN đang chạy)

📖 Mở Swagger UI ↗