Proovik
person
code REST API v1

API nhà phát triển

Tích hợp chứng nhận và truy xuất nguồn gốc blockchain vào các ứng dụng của bạn. Tài liệu đầy đủ và ví dụ sử dụng.

Base URL: https://api.proovik.com/v1
verified

Chứng nhận

Niêm phong tài liệu trên blockchain

POST /certify Chứng nhận tài liệu

Gửi hàm băm tệp để ghi vào blockchain Kaspa. Trả về ID giao dịch và dữ liệu chứng chỉ.

# Yêu cầu 
curl -X POST https://api.proovik.com/v1/certify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "hash": "e3b0c44298fc1c149afbf4c8996fb924...",
    "filename": "contract.pdf",
    "metadata": {"client": "Acme Corp"}
  }'
GET /verify/{hash} Xác minh tài liệu

Kiểm tra xem hàm băm tệp có tồn tại trên blockchain hay không và trả về chi tiết chứng nhận của nó.

# Phản hồi 
{
  "verified": true,
  "txid": "abc123...",
  "timestamp": "2026-01-06T12:00:00Z",
  "block_hash": "...",
  "merkle_proof": [...]
}
conversion_path

Truy xuất nguồn gốc

Chuỗi hành trình sản phẩm với Hash Chaining

POST /trace/batch Tạo lô

Tạo một lô sản phẩm mới để theo dõi. Trả về ID lô duy nhất cho các sự kiện tiếp theo. 

{
  "batch_id": "BATCH-2026-001",
  "product": "Organic Olive Oil",
  "origin": "Jaén, Spain",
  "metadata": {...}
}
POST /trace/event Thêm sự kiện

Thêm một sự kiện mới vào chuỗi lô. Tự động liên kết với sự kiện trước đó thông qua Hash Chaining. 

{
  "batch_id": "BATCH-2026-001",
  "event_type": "HARVEST",
  "evidence_hash": "sha256:...",
  "location": { "lat": 37.77, "lng": -3.79 },
  "data": { "weight_kg": 500, "quality": "A" }
}
info Sự kiện được tự động liên kết với TXID trước đó, tạo ra một chuỗi không thể phá vỡ.
GET /trace/batch/{batch_id} Lấy lịch sử lô

Trả về chuỗi sự kiện hoàn chỉnh cho một lô, với trạng thái xác minh blockchain cho mỗi sự kiện. 

{
  "batch": {...},
  "events": [
    { "type": "SOWING", "txid": "...", "verified": true },
    { "type": "HARVEST", "txid": "...", "verified": true },
    { "type": "TRANSPORT", "txid": "...", "verified": true }
  ],
  "chain_valid": true
}
webhook

Webhooks

Thông báo thời gian thực

Nhận thông báo ngay lập tức khi các giao dịch được xác nhận trên blockchain.

certification.confirmed

Tài liệu đã được chứng nhận

trace.event.confirmed

Sự kiện truy xuất nguồn gốc đã được xác nhận

SDKs

🐍 Python Sắp ra mắt
🟨 JavaScript Sắp ra mắt
🐘 PHP Sắp ra mắt
🔵 Go Sắp ra mắt

Sẵn sàng tích hợp?

Liên hệ với chúng tôi để truy cập API và chúng tôi sẽ giúp bạn bắt đầu.

mail Yêu cầu truy cập API conversion_path Tìm hiểu về truy xuất nguồn gốc