API VeraTrace — προγραμματιστές
Το επίπεδο διατροφικής απόδειξης, μέσω REST. Βεβαιώσεις υπογεγραμμένες με Ed25519, δέντρο Merkle, διαβατήριο προϊόντος σε μορφή DPP — επαληθεύσιμα χωρίς λογαριασμό VeraTrace. Τα endpoints του δακτυλίου 1 παρακάτω καλούνται χωρίς κανένα κλειδί: αντιγράψτε, επικολλήστε, δοκιμάστε.
Δοκιμάστε τώρα
Δεν απαιτείται εγγραφή για την πρώτη κλήση. Το κλειδί χρησιμεύει στη συνέχεια για την άρση της ανώνυμης ποσόστωσης και το άνοιγμα των πηγών αναφοράς του δακτυλίου 2.
# Δακτύλιος 1 — δεν απαιτείται κλειδί. Δοκιμάστε το τώρα αμέσως.
curl "https://veratrace.eu/api/recalls/check/3017620422003"
# → {"ok":true,"recalled":false,"recallCheck":"ok","matches":[]}
# Δακτύλιος 1 — διαβατήριο προϊόντος (DPP), μορφή JSON-LD
# Η παρτίδα «demo» είναι διαβατήριο ΕΠΙΔΕΙΞΗΣ: το έγγραφο το
# δηλώνει ("demonstration": true) και δεν φέρει καμία βεβαίωση.
curl "https://veratrace.eu/api/dpp/demo"
# Δακτύλιος 1 — ανάλυση GS1 Digital Link (επιφάνεια Java)
curl "https://api.veratrace.eu/api/public/v1/gs1/digital-link/parse?url=https://veratrace.eu/01/03123456789012/21/ABC"
# Δακτύλιος 1 — επαλήθευση βεβαίωσης, χωρίς κλειδί και χωρίς λογαριασμό.
# Η υπογραφή Ed25519, η αγκύρωση και η απόδειξη συμπερίληψης είναι ΠΡΑΓΜΑΤΙΚΕΣ· μόνο το
# αντικείμενο είναι φανταστικό. Το δημόσιο κλειδί διατίθεται από το /attestations/trust-anchors.
curl "https://veratrace.eu/api/attestations/0571db99-cc4e-4c00-8bc7-974e50ad89df/verify"
# Δακτύλιος 2 — απαιτείται κλειδί, scope «read»
curl "https://veratrace.eu/api/ciqual/lookup?q=carotte" \
-H "X-VeraTrace-Api-Key: vt_live_ΤΟ_ΚΛΕΙΔΙ_ΣΑΣ"
# Το ίδιο κλειδί περνά και ως Bearer — απολύτως ισοδύναμο
curl "https://veratrace.eu/api/inao/lookup?q=comte" \
-H "Authorization: Bearer vt_live_ΤΟ_ΚΛΕΙΔΙ_ΣΑΣ"Έλεγχος ταυτότητας
Ένα κλειδί προγραμματιστή γράφεται vt_live_… και περνά με δύο τρόπους, απολύτως ισοδύναμους:
X-VeraTrace-Api-Key: vt_live_…Authorization: Bearer vt_live_…
Ένα κλειδί που υπάρχει αλλά είναι άκυρο δεν υποβαθμίζεται ποτέ σε ανώνυμη πρόσβαση: επιστρέφει 401. Οι ταυτοποιημένες απαντήσεις φέρουν X-RateLimit-Remaining-Minute, X-RateLimit-Remaining-Day και X-RateLimit-Reset. Η υπέρβαση επιστρέφει 429 RATE_LIMITED με Retry-After, ένα scope που λείπει 403 INSUFFICIENT_SCOPE.
Τρεις δακτύλιοι πρόσβασης
Κάθε ανοιχτό endpoint ανήκει σε έναν ακριβώς δακτύλιο, ο οποίος ορίζει τον έλεγχο ταυτότητας και το όριο χρήσης του.
Επαλήθευση βεβαιώσεων, διαβατήριο προϊόντος (DPP), ανακλήσεις βάσει EAN, ανάλυση GS1.
Κανένας. Το κλειδί δεν αλλάζει τα δικαιώματά σας: αντικαθιστά το όριο ανά IP με εκείνο του επιπέδου σας και αποδίδει τη χρήση στον λογαριασμό σας.
Εμπλουτισμένα σύνολα αναφοράς: CIQUAL, e-Phy, RPG, DECP, INAO, εγκρίσεις, συγκριτής τιμών, ροή ανακλήσεων.
Κλειδί προγραμματιστή, εύρος «read».
Πιστότητα (earn / redeem), μετρήσεις αλυσίδας ψύξης, καταγραφή EPCIS 2.0.
Κλειδί προγραμματιστή και εύρος εγγραφής ενεργοποιημένο κατά τη δημιουργία: loyalty:write, cold-chain:write, epcis:capture ή qr:write.
Δύο βασικές διευθύνσεις URL
Η πλατφόρμα εκθέτει δύο διακριτές επιφάνειες. Τα σύνολα αναφοράς του δακτυλίου 2, οι ανακλήσεις και το DPP ανταποκρίνονται μόνο στη βάση BFF, χωρίς το πρόθεμα /api/public/v1. Κάθε λειτουργία της προδιαγραφής φέρει τη δική της.
https://api.veratrace.eu/api/public/v1https://veratrace.eu/apiΈνα περιβάλλον δοκιμών (api-sandbox.veratrace.eu) δηλώνεται στην προδιαγραφή στο πλαίσιο του οδικού χάρτη. Δεν έχει ακόμη παρασχεθεί — μην το στοχεύετε.
Προχωρήστε περισσότερο
Αποκτήστε κλειδί
Η δημιουργία είναι αυτοεξυπηρέτηση και άμεση: αρκεί ένας λογαριασμός, χωρίς χειροκίνητη έγκριση. Το επίπεδο Free χορηγείται από προεπιλογή. Το κλειδί εμφανίζεται μόνο μία φορά.