API VeraTrace — dezvoltatori
Stratul de dovadă alimentară, prin REST. Atestări semnate Ed25519, arbore Merkle, pașaport de produs în format DPP — verificabile fără un cont VeraTrace. Endpoint-urile inelului 1 de mai jos se apelează fără nicio cheie: copiați, lipiți, testați.
Încercați acum
Nu este necesară nicio înregistrare pentru primul apel. Cheia servește apoi la ridicarea cotei anonime și la deschiderea referențialelor inelului 2.
# Inelul 1 — nicio cheie necesară. Încercați imediat.
curl "https://veratrace.eu/api/recalls/check/3017620422003"
# → {"ok":true,"recalled":false,"recallCheck":"ok","matches":[]}
# Inelul 1 — pașaport de produs (DPP), format JSON-LD
# Lotul „demo” este un pașaport de DEMONSTRAȚIE: documentul
# îl declară ("demonstration": true) și nu poartă nicio atestare.
curl "https://veratrace.eu/api/dpp/demo"
# Inelul 1 — analiza GS1 Digital Link (suprafața Java)
curl "https://api.veratrace.eu/api/public/v1/gs1/digital-link/parse?url=https://veratrace.eu/01/03123456789012/21/ABC"
# Inelul 1 — verificați o atestare, fără cheie și fără cont.
# Semnătura Ed25519, ancorarea și dovada de includere sunt REALE; doar
# subiectul este fictiv. Cheia publică este servită de /attestations/trust-anchors.
curl "https://veratrace.eu/api/attestations/0571db99-cc4e-4c00-8bc7-974e50ad89df/verify"
# Inelul 2 — cheie necesară, scope „read”
curl "https://veratrace.eu/api/ciqual/lookup?q=carotte" \
-H "X-VeraTrace-Api-Key: vt_live_CHEIA_DUMNEAVOASTRĂ"
# Aceeași cheie se transmite și ca Bearer — strict echivalent
curl "https://veratrace.eu/api/inao/lookup?q=comte" \
-H "Authorization: Bearer vt_live_CHEIA_DUMNEAVOASTRĂ"Autentificare
O cheie de dezvoltator se scrie vt_live_… și se transmite în două moduri, strict echivalente:
X-VeraTrace-Api-Key: vt_live_…Authorization: Bearer vt_live_…
O cheie prezentă, dar invalidă nu este niciodată degradată la acces anonim: returnează 401. Răspunsurile autentificate poartă X-RateLimit-Remaining-Minute, X-RateLimit-Remaining-Day și X-RateLimit-Reset. O depășire returnează 429 RATE_LIMITED cu Retry-After, iar un scope lipsă 403 INSUFFICIENT_SCOPE.
Trei inele de acces
Orice endpoint deschis aparține exact unui inel, care îi stabilește autentificarea și cota.
Verificarea atestărilor, pașaportul de produs (DPP), rechemări după EAN, rezolvare GS1.
Niciuna. Cheia nu vă schimbă drepturile: înlocuiește cota per IP cu cea a nivelului dumneavoastră și atribuie utilizarea contului dumneavoastră.
Referențiale îmbogățite: CIQUAL, e-Phy, RPG, DECP, INAO, autorizări, comparator de prețuri, flux de rechemări.
Cheie de dezvoltator, scope „read”.
Fidelitate (earn / redeem), citiri ale lanțului de frig, captură EPCIS 2.0.
Cheie de dezvoltator + scope de scriere activat la creare: loyalty:write, cold-chain:write, epcis:capture sau qr:write.
Două URL-uri de bază
Platforma expune două suprafețe distincte. Referencialele inelului 2, rechemările și DPP răspund doar pe baza BFF, fără prefixul /api/public/v1. Fiecare operațiune din specificație îl poartă pe al ei.
https://api.veratrace.eu/api/public/v1https://veratrace.eu/apiUn mediu sandbox (api-sandbox.veratrace.eu) este declarat în specificație în cadrul foii de parcurs. Nu este încă pus la dispoziție — nu îl țintiți.
Mergeți mai departe
Obțineți o cheie
Crearea este self-service și imediată: un cont este suficient, fără validare manuală. Nivelul Free este atribuit implicit. Cheia este afișată o singură dată.