Documentazione API VeraTrace
Documentazione interattiva delle API VeraTrace, generata dalle specifiche OpenAPI 3.1 (canonicalizzate nel monorepo) e resa tramite Scalar.
Specifiche disponibili
Public API
Endpoint consumatore (scansione QR/NFC, GS1 Digital Link, EPCIS, attestazioni pubbliche, DFC). Non autenticato o chiave API partner.
App API
Superficie BFF interna (lotti, certificati, bilanci carbonio, EUDR, ricette...). Autenticazione di sessione richiesta — riservata agli integratori con contratto.
Webhooks Ekylibre
Contratto di ricezione dei webhook Ekylibre (HMAC SHA-256, envelope versionato). Token firmati per lotto.
Le specifiche YAML grezze sono servite anche in /api/specs/<name> (Content-Type application/yaml). Cache CDN 5 min. Il viewer Scalar qui sopra non richiede alcuna chiamata in uscita: le specifiche sono compilate nel bundle Next.