VeraTrace-API — Entwickler
Die Nachweisschicht für Lebensmittel, als REST. Ed25519-signierte Attestierungen, Merkle-Baum, Produktpass im DPP-Format — ohne VeraTrace-Konto überprüfbar. Die Endpunkte von Ring 1 unten werden ganz ohne Schlüssel aufgerufen: kopieren, einfügen, testen.
Jetzt ausprobieren
Für den ersten Aufruf ist keine Registrierung nötig. Der Schlüssel hebt anschließend das anonyme Kontingent auf und schaltet die Referenzdaten von Ring 2 frei.
# Ring 1 — kein Schlüssel erforderlich. Probieren Sie es gleich aus.
curl "https://veratrace.eu/api/recalls/check/3017620422003"
# → {"ok":true,"recalled":false,"recallCheck":"ok","matches":[]}
# Ring 1 — Produktpass (DPP), Format JSON-LD
# Die Charge „demo“ ist ein DEMONSTRATIONS-Produktpass: Das Dokument
# deklariert dies ("demonstration": true) und enthält keine Attestierung.
curl "https://veratrace.eu/api/dpp/demo"
# Ring 1 — Parsing von GS1 Digital Link (Java-Oberfläche)
curl "https://api.veratrace.eu/api/public/v1/gs1/digital-link/parse?url=https://veratrace.eu/01/03123456789012/21/ABC"
# Ring 1 — eine Attestierung prüfen, ohne Schlüssel und ohne Konto.
# Ed25519-Signatur, Verankerung und Inklusionsnachweis sind ECHT; nur das
# Subjekt ist fiktiv. Der öffentliche Schlüssel wird unter /attestations/trust-anchors bereitgestellt.
curl "https://veratrace.eu/api/attestations/0571db99-cc4e-4c00-8bc7-974e50ad89df/verify"
# Ring 2 — Schlüssel erforderlich, Scope „read“
curl "https://veratrace.eu/api/ciqual/lookup?q=carotte" \
-H "X-VeraTrace-Api-Key: vt_live_IHR_SCHLÜSSEL"
# Derselbe Schlüssel funktioniert auch als Bearer — vollständig gleichwertig
curl "https://veratrace.eu/api/inao/lookup?q=comte" \
-H "Authorization: Bearer vt_live_IHR_SCHLÜSSEL"Authentifizierung
Ein Entwicklerschlüssel hat die Form vt_live_… und wird auf zwei vollständig gleichwertige Arten übergeben:
X-VeraTrace-Api-Key: vt_live_…Authorization: Bearer vt_live_…
Ein vorhandener, aber ungültiger Schlüssel wird nie zu anonymem Zugriff herabgestuft: Er liefert 401. Authentifizierte Antworten enthalten X-RateLimit-Remaining-Minute, X-RateLimit-Remaining-Day und X-RateLimit-Reset. Eine Überschreitung liefert 429 RATE_LIMITED mit Retry-After, ein fehlender Scope 403 INSUFFICIENT_SCOPE.
Drei Zugangsringe
Jeder offene Endpunkt gehört zu genau einem Ring, der seine Authentifizierung und sein Kontingent festlegt.
Prüfung von Attestierungen, Produktpass (DPP), Rückrufe nach EAN, GS1-Auflösung.
Keine. Der Schlüssel ändert Ihre Rechte nicht: Er ersetzt das Kontingent pro IP durch das Ihrer Stufe und ordnet die Nutzung Ihrem Konto zu.
Angereicherte Referenzdaten: CIQUAL, e-Phy, RPG, DECP, INAO, Zulassungen, Preisvergleich, Rückruf-Feed.
Entwicklerschlüssel, Scope „read“.
Treueprogramm (earn / redeem), Messwerte der Kühlkette, EPCIS-2.0-Erfassung.
Entwicklerschlüssel plus bei der Erstellung aktivierter Schreib-Scope: loyalty:write, cold-chain:write, epcis:capture oder qr:write.
Zwei Basis-URLs
Die Plattform stellt zwei getrennte Oberflächen bereit. Die Referenzdaten von Ring 2, die Rückrufe und der Produktpass antworten nur auf der BFF-Basis, ohne das Präfix /api/public/v1. Jede Operation der Spezifikation trägt ihre eigene.
https://api.veratrace.eu/api/public/v1https://veratrace.eu/apiEine Sandbox-Umgebung (api-sandbox.veratrace.eu) ist in der Spezifikation als Teil der Roadmap deklariert. Sie ist noch nicht bereitgestellt — verwenden Sie sie nicht als Ziel.
Weiterführend
Schlüssel erhalten
Die Erstellung erfolgt per Self-Service und sofort: Ein Konto genügt, keine manuelle Freigabe. Standardmäßig wird die Stufe Free vergeben. Der Schlüssel wird nur ein einziges Mal angezeigt.