GS1-resolver

De GS1-resolver is de openbare leeslaag voor een DPP. De kanonische URL ziet er als volgt uit:

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 en lot moeten veilige GS1-padsegmenten gebruiken: alleen A-Z, a-z, 0-9, ., _, ~, - en een lengte van 1 tot 20 tekens. Gereserveerde URL-scheidingstekens worden geweigerd, zodat de kanonische link herleidbaar blijft.

Content Negotiation

Dezelfde resolver levert afhankelijk van de Accept-header verschillende weergaven:

Accept	Antwoord
`text/html`	Consumenten-HTML
`application/ld+json`	JSON-LD
`application/json`	Ruwe DPP-JSON
`application/linkset+json`	Linkset met alternatieven

Openbaar zichtbare routes

GET /01/... is de kanonische resolver
GET /dpp/:gtin/:serial?lot=... is een HTML-alias
GET /v1/dpp/:id/qr.svg levert de SVG
GET /v1/dpp/:id/qr.png levert de PNG
GET /v1/dpp/:id/qr.pdf levert de PDF
GET /v1/dpp/:id/qr.eps levert de EPS

De zichtbaarheid van de QR-assets is afhankelijk van de DPP-status:

live is zonder authenticatie openbaar opvraagbaar
draft en archived vereisen een geldige authenticatiecontext plus workspace-toegang
Ongeldige authenticatie levert 401 op
Niet-zichtbare of externe workspaces leveren 404 op

Fallback

Als qr3.app geen resultaat vindt, wordt er doorgestuurd naar de bovenliggende GS1-resolver. Dit is belangrijk zodat gedrukte codes ook werken wanneer een product nog niet lokaal is geregistreerd.

Praktijk

Maak een DPP aan in het dashboard.
Gebruik de GS1-URI als QR-doel.
Leid consumerende systemen via Accept naar het gewenste formaat.