API VeraTrace — dla deweloperów
Warstwa dowodowa dla żywności, przez REST. Poświadczenia podpisane Ed25519, drzewo Merkle, paszport produktu w formacie DPP — weryfikowalne bez konta VeraTrace. Endpointy kręgu 1 poniżej nie wymagają żadnego klucza: skopiuj, wklej, przetestuj.
Wypróbuj teraz
Pierwsze wywołanie nie wymaga rejestracji. Klucz służy następnie do zniesienia limitu anonimowego i otwarcia danych referencyjnych kręgu 2.
# Krąg 1 — klucz niewymagany. Można wypróbować od razu.
curl "https://veratrace.eu/api/recalls/check/3017620422003"
# → {"ok":true,"recalled":false,"recallCheck":"ok","matches":[]}
# Krąg 1 — paszport produktu (DPP), format JSON-LD
# Partia „demo” jest paszportem DEMONSTRACYJNYM: dokument sam to
# deklaruje ("demonstration": true) i nie zawiera żadnego poświadczenia.
curl "https://veratrace.eu/api/dpp/demo"
# Krąg 1 — analiza GS1 Digital Link (powierzchnia Java)
curl "https://api.veratrace.eu/api/public/v1/gs1/digital-link/parse?url=https://veratrace.eu/01/03123456789012/21/ABC"
# Krąg 1 — weryfikacja poświadczenia, bez klucza i bez konta.
# Podpis Ed25519, zakotwiczenie i dowód włączenia są PRAWDZIWE; fikcyjny
# jest tylko przedmiot. Klucz publiczny udostępnia /attestations/trust-anchors.
curl "https://veratrace.eu/api/attestations/0571db99-cc4e-4c00-8bc7-974e50ad89df/verify"
# Krąg 2 — klucz wymagany, zakres „read”
curl "https://veratrace.eu/api/ciqual/lookup?q=carotte" \
-H "X-VeraTrace-Api-Key: vt_live_TWOJ_KLUCZ"
# Ten sam klucz działa także jako Bearer — w pełni równoważnie
curl "https://veratrace.eu/api/inao/lookup?q=comte" \
-H "Authorization: Bearer vt_live_TWOJ_KLUCZ"Uwierzytelnianie
Klucz deweloperski ma postać vt_live_… i można go przekazać na dwa sposoby, w pełni równoważne:
X-VeraTrace-Api-Key: vt_live_…Authorization: Bearer vt_live_…
Klucz obecny, ale nieprawidłowy nigdy nie jest obniżany do dostępu anonimowego: zwraca 401. Odpowiedzi uwierzytelnione zawierają X-RateLimit-Remaining-Minute, X-RateLimit-Remaining-Day i X-RateLimit-Reset. Przekroczenie limitu zwraca 429 RATE_LIMITED z Retry-After, brak zakresu — 403 INSUFFICIENT_SCOPE.
Trzy kręgi dostępu
Każdy otwarty endpoint należy do dokładnie jednego kręgu, który określa jego uwierzytelnianie i limit.
Weryfikacja poświadczeń, paszport produktu (DPP), wycofania według EAN, rozpoznawanie GS1.
Brak. Klucz nie zmienia Pana/Pani uprawnień: zastępuje limit na adres IP limitem Pana/Pani planu i przypisuje wykorzystanie do Pana/Pani konta.
Wzbogacone dane referencyjne: CIQUAL, e-Phy, RPG, DECP, INAO, zatwierdzenia, porównywarka cen, kanał wycofań.
Klucz deweloperski, zakres „read”.
Lojalność (naliczanie / wymiana), odczyty łańcucha chłodniczego, rejestrowanie EPCIS 2.0.
Klucz deweloperski plus zakres zapisu włączony przy tworzeniu: loyalty:write, cold-chain:write, epcis:capture lub qr:write.
Dwa bazowe adresy URL
Platforma udostępnia dwie odrębne powierzchnie. Dane referencyjne kręgu 2, wycofania i DPP odpowiadają tylko pod bazą BFF, bez prefiksu /api/public/v1. Każda operacja w specyfikacji ma własną.
https://api.veratrace.eu/api/public/v1https://veratrace.eu/apiŚrodowisko piaskownicy (api-sandbox.veratrace.eu) jest zadeklarowane w specyfikacji w ramach planu rozwoju. Nie jest jeszcze uruchomione — nie należy z niego korzystać.
Dalsze kroki
Uzyskaj klucz
Tworzenie jest samoobsługowe i natychmiastowe: wystarczy konto, bez ręcznej akceptacji. Domyślnie przypisywany jest plan Free. Klucz jest wyświetlany tylko raz.