GS1-resolver

GS1-resolvern är det offentliga lässkiktet för ett DPP. Den kanoniska URL:en ser ut så här:

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 och lot måste använda säkra GS1-sökvägssegment: endast A-Z, a-z, 0-9, ., _, ~, - och en längd på 1 till 20 tecken. Reserverade URL-avgränsare avvisas för att den kanoniska länken ska förbli upplösningsbar.

Content negotiation

Samma resolver levererar olika representationer beroende på Accept-headern:

Accept	Svar
`text/html`	Konsument-HTML
`application/ld+json`	JSON-LD
`application/json`	Rå DPP-JSON
`application/linkset+json`	Linkset med alternativ

Offentligt synliga rutter

GET /01/... är den kanoniska resolvern
GET /dpp/:gtin/:serial?lot=... är ett HTML-alias
GET /v1/dpp/:id/qr.svg returnerar SVG:n
GET /v1/dpp/:id/qr.png returnerar PNG:n
GET /v1/dpp/:id/qr.pdf returnerar PDF:en
GET /v1/dpp/:id/qr.eps returnerar EPS:en

Synligheten för QR-tillgångar styrs av DPP-statusen:

live är offentligt tillgänglig utan autentisering
draft och archived kräver en giltig autentiseringskontext samt workspace-åtkomst
Ogiltig autentisering returnerar 401
Icke-synliga eller externa workspaces returnerar 404

Fallback

Om qr3.app inte hittar någon matchning vidarebefordras anropet till den överordnade GS1-resolvern. Detta är viktigt för att tryckta koder ska fungera även om en produkt ännu inte är registrerad lokalt.

Praktisk användning

Skapa DPP i instrumentpanelen (dashboard).
Använd GS1-URI:n som QR-mål.
Styr konsumerande system till önskat format via Accept.