API VeraTrace — sviluppatori
Il livello di prova alimentare, in REST. Attestazioni firmate Ed25519, albero di Merkle, passaporto prodotto in formato DPP — verificabili senza un account VeraTrace. Gli endpoint dell'anello 1 qui sotto si chiamano senza alcuna chiave: copi, incolli, provi.
Provi ora
Non è necessaria alcuna registrazione per la prima chiamata. La chiave serve poi a sollevare la quota anonima e ad aprire i riferimenti dell'anello 2.
# Anello 1 — nessuna chiave richiesta. Provi subito.
curl "https://veratrace.eu/api/recalls/check/3017620422003"
# → {"ok":true,"recalled":false,"recallCheck":"ok","matches":[]}
# Anello 1 — passaporto prodotto (DPP), formato JSON-LD
# Il lotto «demo» è un passaporto di DIMOSTRAZIONE: il documento lo
# dichiara ("demonstration": true) e non contiene alcuna attestazione.
curl "https://veratrace.eu/api/dpp/demo"
# Anello 1 — parsing GS1 Digital Link (superficie Java)
curl "https://api.veratrace.eu/api/public/v1/gs1/digital-link/parse?url=https://veratrace.eu/01/03123456789012/21/ABC"
# Anello 1 — verificare un'attestazione, senza chiave né account.
# La firma Ed25519, l'ancoraggio e la prova di inclusione sono REALI; solo il
# soggetto è fittizio. La chiave pubblica è servita da /attestations/trust-anchors.
curl "https://veratrace.eu/api/attestations/0571db99-cc4e-4c00-8bc7-974e50ad89df/verify"
# Anello 2 — chiave richiesta, scope «read»
curl "https://veratrace.eu/api/ciqual/lookup?q=carotte" \
-H "X-VeraTrace-Api-Key: vt_live_LA_SUA_CHIAVE"
# La stessa chiave funziona anche come Bearer — rigorosamente equivalente
curl "https://veratrace.eu/api/inao/lookup?q=comte" \
-H "Authorization: Bearer vt_live_LA_SUA_CHIAVE"Autenticazione
Una chiave sviluppatore si scrive vt_live_… e si passa in due modi, rigorosamente equivalenti:
X-VeraTrace-Api-Key: vt_live_…Authorization: Bearer vt_live_…
Una chiave presente ma non valida non viene mai declassata ad accesso anonimo: restituisce 401. Le risposte autenticate riportano X-RateLimit-Remaining-Minute, X-RateLimit-Remaining-Day e X-RateLimit-Reset. Un superamento restituisce 429 RATE_LIMITED con Retry-After, uno scope mancante 403 INSUFFICIENT_SCOPE.
Tre anelli di accesso
Ogni endpoint aperto appartiene a esattamente un anello, che ne fissa l'autenticazione e la quota.
Verifica di attestazioni, passaporto prodotto (DPP), richiami per EAN, risoluzione GS1.
Nessuna. La chiave non cambia i suoi diritti: sostituisce la quota per IP con quella del suo livello e attribuisce l'utilizzo al suo account.
Riferimenti arricchiti: CIQUAL, e-Phy, RPG, DECP, INAO, riconoscimenti, comparatore di prezzi, feed dei richiami.
Chiave sviluppatore, scope «read».
Fedeltà (earn / redeem), rilevazioni della catena del freddo, acquisizione EPCIS 2.0.
Chiave sviluppatore + scope di scrittura attivato alla creazione: loyalty:write, cold-chain:write, epcis:capture o qr:write.
Due URL di base
La piattaforma espone due superfici distinte. I riferimenti dell'anello 2, i richiami e il DPP rispondono solo sulla base BFF, senza il prefisso /api/public/v1. Ogni operazione della specifica porta la propria.
https://api.veratrace.eu/api/public/v1https://veratrace.eu/apiUn ambiente sandbox (api-sandbox.veratrace.eu) è dichiarato nella specifica a titolo di tabella di marcia. Non è ancora predisposto — non lo usi come destinazione.
Per approfondire
Ottenere una chiave
La creazione è self-service e immediata: basta un account, nessuna convalida manuale. Il livello Free è assegnato per impostazione predefinita. La chiave viene mostrata una sola volta.