Proovik
person
code REST API v1

API Sviluppatore

Integra la certificazione e la tracciabilità blockchain nelle tue applicazioni. Documentazione completa ed esempi di utilizzo.

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

Certificazione

Sigilla documenti sulla blockchain

POST /certify Certificare un documento

Invia un hash di file da registrare sulla blockchain Kaspa. Restituisce un ID transazione e i dati del certificato.

# Richiesta 
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} Verificare un documento

Verifica se un hash di file esiste sulla blockchain e restituisce i dettagli della certificazione.

# Risposta 
{
  "verified": true,
  "txid": "abc123...",
  "timestamp": "2026-01-06T12:00:00Z",
  "block_hash": "...",
  "merkle_proof": [...]
}
conversion_path

Tracciabilità

Catena di custodia con Hash Chaining

POST /trace/batch Crea lotto

Crea un nuovo lotto di prodotti da tracciare. Restituisce un ID lotto univoco per gli eventi successivi. 

{
  "batch_id": "BATCH-2026-001",
  "product": "Organic Olive Oil",
  "origin": "Jaén, Spain",
  "metadata": {...}
}
POST /trace/event Aggiungi evento

Aggiunge un nuovo evento alla catena del lotto. Si collega automaticamente all'evento precedente tramite 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 L'evento viene automaticamente concatenato al TXID precedente, creando una sequenza indistruttibile.
GET /trace/batch/{batch_id} Ottieni cronologia lotto

Restituisce la catena completa degli eventi per un lotto, con stato di verifica blockchain per ogni evento. 

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

Webhooks

Notifiche in tempo reale

Ricevi notifiche istantanee quando le transazioni vengono confermate sulla blockchain.

certification.confirmed

Documento certificato

trace.event.confirmed

Evento di tracciabilità confermato

SDKs

🐍 Python Prossimamente
🟨 JavaScript Prossimamente
🐘 PHP Prossimamente
🔵 Go Prossimamente

Pronto per l'integrazione?

Contattaci per l'accesso API e ti aiuteremo a iniziare.

mail Richiedi accesso API conversion_path Scopri la tracciabilità