Proovik
person
code REST API v1

API Développeur

Intégrez la certification et la traçabilité blockchain dans vos applications. Documentation complète et exemples d'utilisation.

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

Certification

Sceller les documents sur la blockchain

POST /certify Certifier un document

Soumet un hachage de fichier à enregistrer sur la blockchain Kaspa. Renvoie un ID de transaction et des données de certificat.

# Demande 
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} Vérifier un document

Vérifie si un hachage de fichier existe sur la blockchain et renvoie ses détails de certification.

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

Traçabilité

Chaîne de possession avec Hash Chaining

POST /trace/batch Créer un lot

Crée un nouveau lot de produits à suivre. Renvoie un ID de lot unique pour les événements ultérieurs. 

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

Ajoute un nouvel événement à la chaîne du lot. Lie automatiquement à l'événement précédent via 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'événement est automatiquement enchaîné au TXID précédent, créant une séquence incassable.
GET /trace/batch/{batch_id} Obtenir l'historique du lot

Renvoie la chaîne complète des événements pour un lot, avec l'état de vérification blockchain pour chaque événement. 

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

Webhooks

Notifications en temps réel

Recevez des notifications instantanées lorsque les transactions sont confirmées sur la blockchain.

certification.confirmed

Document certifié

trace.event.confirmed

Événement de traçabilité confirmé

SDKs

🐍 Python Bientôt disponible
🟨 JavaScript Bientôt disponible
🐘 PHP Bientôt disponible
🔵 Go Bientôt disponible

Prêt à intégrer?

Contactez-nous pour l'accès à l'API et nous vous aiderons à démarrer.

mail Demander l'accès à l'API conversion_path En savoir plus sur la traçabilité