Proovik
person
code REST API v1

Entwickler-API

Integrieren Sie Blockchain-Zertifizierung und Rückverfolgbarkeit in Ihre Anwendungen. Vollständige Dokumentation und Anwendungsbeispiele.

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

Zertifizierung

Dokumente auf der Blockchain versiegeln

POST /certify Dokument zertifizieren

Sendet einen Datei-Hash zur Aufzeichnung auf der Kaspa-Blockchain. Gibt eine Transaktions-ID und Zertifikatsdaten zurück.

# Anfrage 
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} Dokument überprüfen

Überprüft, ob ein Datei-Hash auf der Blockchain existiert und gibt die Zertifizierungsdetails zurück.

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

Rückverfolgbarkeit

Verwahrungskette mit Hash-Verkettung

POST /trace/batch Charge erstellen

Erstellt eine neue Produktcharge zum Verfolgen. Gibt eine eindeutige Chargen-ID für nachfolgende Ereignisse zurück. 

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

Fügt der Chargenkette ein neues Ereignis hinzu. Verknüpft automatisch über Hash-Verkettung mit dem vorherigen Ereignis. 

{
  "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 Das Ereignis wird automatisch mit der vorherigen TXID verkettet, wodurch eine unzerbrechliche Sequenz entsteht.
GET /trace/batch/{batch_id} Chargenhistorie abrufen

Gibt die vollständige Ereigniskette für eine Charge zurück, mit Blockchain-Verifizierungsstatus für jedes Ereignis. 

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

Webhooks

Echtzeit-Benachrichtigungen

Erhalten Sie sofortige Benachrichtigungen, wenn Transaktionen auf der Blockchain bestätigt werden.

certification.confirmed

Dokument zertifiziert

trace.event.confirmed

Rückverfolgungsereignis bestätigt

SDKs

🐍 Python Demnächst
🟨 JavaScript Demnächst
🐘 PHP Demnächst
🔵 Go Demnächst

Bereit zur Integration?

Kontaktieren Sie uns für API-Zugriff und wir helfen Ihnen beim Einstieg.

mail API-Zugriff anfordern conversion_path Über Rückverfolgbarkeit erfahren