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}

Τα 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

Εάν το qr3.app δεν βρει κάποιο αποτέλεσμα, ανακατευθύνει στον υπερκείμενο GS1 Resolver. Αυτό είναι σημαντικό ώστε οι εκτυπωμένοι κώδικες να λειτουργούν ακόμη και αν ένα προϊόν δεν έχει ακόμη καταχωρηθεί τοπικά.

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

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