GS1-Resolver

A GS1-Resolver a DPP nyilvános olvasási rétege. A kanonikus URL így néz ki:

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}

A serial és lot értékeknek biztonságos GS1 útvonalszegmenseket kell használniuk: csak A-Z, a-z, 0-9, ., _, ~, - karaktereket, és a hosszuk 1-től 20 karakterig terjedhet. A fenntartott URL-elválasztó karakterek elutasításra kerülnek, hogy a kanonikus link feloldható maradjon.

Content Negotiation

Ugyanaz a feloldó az Accept fejléc függvényében különböző reprezentációkat ad vissza:

Accept	Válasz
`text/html`	Fogyasztói HTML
`application/ld+json`	JSON-LD
`application/json`	Nyers DPP JSON
`application/linkset+json`	Linkset alternatívákkal

Nyilvánosan elérhető útvonalak

GET /01/... a kanonikus feloldó (resolver)
GET /dpp/:gtin/:serial?lot=... egy HTML álnév (alias)
GET /v1/dpp/:id/qr.svg visszaadja az SVG-t
GET /v1/dpp/:id/qr.png visszaadja a PNG-t
GET /v1/dpp/:id/qr.pdf visszaadja a PDF-et
GET /v1/dpp/:id/qr.eps visszaadja az EPS-t

A QR-eszközök (assets) láthatósága a DPP állapotától függ:

A live hitelesítés nélkül, nyilvánosan elérhető
A draft és archived állapotokhoz érvényes hitelesítési kontextus (Auth) és Workspace-hozzáférés szükséges
Érvénytelen hitelesítés esetén 401 választ ad
A nem látható vagy idegen Workspace-ek 404 választ adnak

Fallback

Ha a qr3.app nem talál egyezést, a kérés továbbításra kerül a szülő GS1-Resolverhez. Ez azért fontos, hogy a nyomtatott kódok akkor is működjenek, ha a termék még nincs helyileg regisztrálva.

Gyakorlati alkalmazás

Hozza létre a DPP-t az irányítópulton (Dashboard).
Használja a GS1 URI-t QR-célként.
Irányítsa a fogyasztó rendszereket a kívánt formátumra az Accept fejléc segítségével.