VeraTrace API — udviklere
Fødevarebeviset som lag, over REST. Ed25519-signerede attestationer, Merkle-træ, produktpas i DPP-format — kan verificeres uden en VeraTrace-konto. Endpoints i ring 1 nedenfor kaldes helt uden nøgle: kopiér, indsæt, test.
Prøv nu
Ingen tilmelding er nødvendig til det første kald. Nøglen bruges derefter til at ophæve den anonyme kvote og åbne ring 2-referencedata.
# Ring 1 — ingen nøgle påkrævet. Prøv det med det samme.
curl "https://veratrace.eu/api/recalls/check/3017620422003"
# → {"ok":true,"recalled":false,"recallCheck":"ok","matches":[]}
# Ring 1 — produktpas (DPP), JSON-LD-format
# Partiet „demo“ er et DEMONSTRATIONSPAS: dokumentet
# angiver det selv ("demonstration": true) og indeholder ingen attestation.
curl "https://veratrace.eu/api/dpp/demo"
# Ring 1 — parsing af GS1 Digital Link (Java-overflade)
curl "https://api.veratrace.eu/api/public/v1/gs1/digital-link/parse?url=https://veratrace.eu/01/03123456789012/21/ABC"
# Ring 1 — verificér en attestation, uden nøgle og uden konto.
# Ed25519-signaturen, forankringen og inklusionsbeviset er ÆGTE; kun
# emnet er fiktivt. Den offentlige nøgle leveres af /attestations/trust-anchors.
curl "https://veratrace.eu/api/attestations/0571db99-cc4e-4c00-8bc7-974e50ad89df/verify"
# Ring 2 — nøgle påkrævet, scope „read“
curl "https://veratrace.eu/api/ciqual/lookup?q=carotte" \
-H "X-VeraTrace-Api-Key: vt_live_DIN_NØGLE"
# Den samme nøgle fungerer også som Bearer — strengt ækvivalent
curl "https://veratrace.eu/api/inao/lookup?q=comte" \
-H "Authorization: Bearer vt_live_DIN_NØGLE"Autentificering
En udviklernøgle skrives vt_live_… og kan sendes på to måder, strengt ækvivalente:
X-VeraTrace-Api-Key: vt_live_…Authorization: Bearer vt_live_…
En nøgle, der er til stede men ugyldig, nedgraderes aldrig til anonym adgang: den returnerer 401. Autentificerede svar indeholder X-RateLimit-Remaining-Minute, X-RateLimit-Remaining-Day og X-RateLimit-Reset. En overskridelse returnerer 429 RATE_LIMITED med Retry-After, et manglende scope 403 INSUFFICIENT_SCOPE.
Tre adgangsringe
Hvert åbent endpoint hører til præcis én ring, som fastlægger dets godkendelse og kvote.
Verificering af attesteringer, produktpas (DPP), tilbagekaldelser efter EAN, GS1-opløsning.
Ingen. Nøglen ændrer ikke dine rettigheder: den erstatter kvoten pr. IP med kvoten for dit niveau og tilskriver forbruget til din konto.
Berigede referencedata: CIQUAL, e-Phy, RPG, DECP, INAO, godkendelser, prissammenligning, feed med tilbagekaldelser.
Udviklernøgle, scope »read«.
Loyalitet (earn / redeem), kølekædeaflæsninger, EPCIS 2.0-registrering.
Udviklernøgle + skrive-scope aktiveret ved oprettelsen: loyalty:write, cold-chain:write, epcis:capture eller qr:write.
To basis-URL’er
Platformen har to adskilte flader. Referencedataene i ring 2, tilbagekaldelserne og DPP svarer kun på BFF-basen, uden præfikset /api/public/v1. Hver operation i specifikationen angiver sin egen.
https://api.veratrace.eu/api/public/v1https://veratrace.eu/apiEt sandkassemiljø (api-sandbox.veratrace.eu) er angivet i specifikationen som led i køreplanen. Det er endnu ikke oprettet — brug det ikke.
Gå videre
Få en nøgle
Oprettelsen er selvbetjent og øjeblikkelig: en konto er nok, ingen manuel godkendelse. Niveauet Free tildeles som standard. Nøglen vises kun én gang.