GS1 Resolver

GS1 Resolver

Ο GS1 Resolver είναι το δημόσιο επίπεδο ανάγνωσης για ένα DPP. Η κανονική URL έχει ως εξής:

https://qr3.app/01/{GTIN}
https://qr3.app/01/{GTIN}/10/{LOT}
https://qr3.app/01/{GTIN}/21/{SERIAL}
https://qr3.app/01/{GTIN}/10/{LOT}/21/{SERIAL}

Κατά τη δημιουργία ενός DPP (POST /v1/dpp) ισχύουν τα εξής: Τα serial και lot πρέπει να χρησιμοποιούν ασφαλή τμήματα διαδρομής GS1: μόνο A-Z, a-z, 0-9, ., _, ~, - και μήκος από 1 έως 20 χαρακτήρες. Οι δεσμευμένοι διαχωριστές URL απορρίπτονται, ώστε ο κανονικός σύνδεσμος να παραμένει επιλύσιμος.

Content Negotiation

Ο ίδιος resolver παρέχει διαφορετικές αναπαραστάσεις ανάλογα με την κεφαλίδα Accept:

Accept	Απάντηση
text/html	HTML καταναλωτή
application/ld+json	JSON-LD
application/json	Ακατέργαστο DPP JSON
application/linkset+json	Linkset με εναλλακτικές επιλογές

Δημόσια ορατές διαδρομές

• GET /01/... είναι ο κανονικός resolver
• GET /dpp/:gtin/:serial?lot=... είναι ένα ψευδώνυμο HTML
• GET /v1/dpp/:id/qr.svg επιστρέφει το SVG
• GET /v1/dpp/:id/qr.png επιστρέφει το PNG
• GET /v1/dpp/:id/qr.pdf επιστρέφει το PDF
• GET /v1/dpp/:id/qr.eps επιστρέφει το EPS

Η ορατότητα των στοιχείων QR εξαρτάται από την κατάσταση του DPP:

• Η κατάσταση live είναι δημόσια προσβάσιμη χωρίς έλεγχο ταυτότητας
• Οι καταστάσεις draft και archived απαιτούν ένα έγκυρο πλαίσιο ελέγχου ταυτότητας και πρόσβαση στο Workspace
• Ο μη έγκυρος έλεγχος ταυτότητας επιστρέφει 401
• Μη ορατά ή ξένα Workspaces επιστρέφουν 404

Fallback

Αν ο GS1 Resolver δεν βρει τοπική αντιστοίχιση, ανακατευθύνει με 307 στο https://id.gs1.org. Για το ψευδώνυμο GTIN /dpp/:gtin/:serial?lot=... αυτό ισχύει και με μη έγκυρο ψηφίο ελέγχου GTIN: τα gtin, lot και serial κωδικοποιούνται χωριστά ως τμήματα URL, συμπεριλαμβανομένων των δεσμευμένων διαχωριστών. Η ανακατεύθυνση δεν επιβεβαιώνει την εγκυρότητα του GTIN ή τη διαθεσιμότητα δεδομένων στη GS1.

Εξαίρεση: αν ένα αποκωδικοποιημένο αναγνωριστικό είναι μόνο . ή .., το ψευδώνυμο χωρίς τοπική αντιστοίχιση απαντά με 422, application/problem+json, τύπο https://docs.qr3.app/errors/validation και το σχετικό πεδίο στο errors[], χωρίς ανακατεύθυνση. Οι αναλυτές URL κανονικοποιούν αυτά τα τμήματα ακόμη και σε κωδικοποιημένη μορφή. Τιμές όπως LOT.1 και ... μπορούν να προωθούνται. Η εξαίρεση αφορά μόνο αυτό το ψευδώνυμο χωρίς αντιστοίχιση· η επικύρωση δημιουργίας, ο κανονικός resolver και οι υπάρχουσες αντιστοιχίσεις παραμένουν αμετάβλητα.

GET /dpp/{GTIN}/UNKNOWN?lot=LOT%2F1
307 Location: https://id.gs1.org/01/{GTIN}/10/LOT%2F1/21/UNKNOWN

GET /dpp/{GTIN}/UNKNOWN?lot=.
422 Content-Type: application/problem+json

Πρακτική εφαρμογή

1. Δημιουργήστε ένα DPP στο Dashboard.
2. Χρησιμοποιήστε το GS1 URI ως προορισμό του QR.
3. Κατευθύνετε τα συστήματα κατανάλωσης στη μορφή που επιθυμούν μέσω της κεφαλίδας Accept.