GS1-lahendaja

GS1-lahendaja on DPP avalik lugemiskiht. Kanooniline URL näeb välja selline:

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 ja lot peavad kasutama turvalisi GS1 teekonna segmente: ainult A-Z, a-z, 0-9, ., _, ~, - ja pikkusega 1 kuni 20 märki. Reserveeritud URL-i eraldajad lükatakse tagasi, et kanooniline link jääks lahendatavaks.

Sisuläbirääkimised (Content Negotiation)

Sama lahendaja tagastab sõltuvalt päisest Accept erinevaid esitusi:

Accept	Vastus
`text/html`	Tarbija HTML
`application/ld+json`	JSON-LD
`application/json`	Toores DPP-JSON
`application/linkset+json`	Alternatiividega linkset

Avalikult nähtavad teekonnad

GET /01/... on kanooniline lahendaja
GET /dpp/:gtin/:serial?lot=... on HTML-alias
GET /v1/dpp/:id/qr.svg tagastab SVG
GET /v1/dpp/:id/qr.png tagastab PNG
GET /v1/dpp/:id/qr.pdf tagastab PDF-i
GET /v1/dpp/:id/qr.eps tagastab EPS-i

QR-varade nähtavus sõltub DPP olekust:

live on ilma autentimiseta avalikult kättesaadav
draft ja archived vajavad kehtivat autentimiskonteksti ja tööruumi (Workspace) juurdepääsu
Vigane autentimine tagastab koodi 401
Mittenähtavad oder võõrad tööruumid tagastavad koodi 404

Varukäitumine (Fallback)

Kui qr3.app ei leia vastet, suunatakse päring edasi ülemisele GS1-lahendajale. See on oluline, et prinditud koodid töötaksid ka siis, kui toode pole veel kohalikult registreeritud.

Praktika

Loo DPP juhtpaneelil (Dashboard).
Kasuta GS1 URI-d QR-koodi sihtkohana.
Suuna tarbivad süsteemid päise Accept abil soovitud vormingule.