GS1-resolver

GS1-resolveren er det offentlige læselag for et DPP. Den kanoniske URL ser således ud:

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 og lot skal bruge sikre GS1-stisegmenter: kun A-Z, a-z, 0-9, ., _, ~, - og en længde på 1 til 20 tegn. Reserverede URL-separatorer afvises, så det kanoniske link forbliver opløseligt.

Content Negotiation

Den samme resolver leverer forskellige repræsentationer afhængigt af Accept-headeren:

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

Offentligt synlige ruter

GET /01/... er den kanoniske resolver
GET /dpp/:gtin/:serial?lot=... er et HTML-alias
GET /v1/dpp/:id/qr.svg leverer SVG’en
GET /v1/dpp/:id/qr.png leverer PNG’en
GET /v1/dpp/:id/qr.pdf leverer PDF’en
GET /v1/dpp/:id/qr.eps leverer EPS’en

Synligheden af QR-aktiverne afhænger af DPP-statussen:

live er offentligt tilgængelig uden godkendelse
draft og archived kræver en gyldig Auth-kontekst plus Workspace-adgang
Ugyldig godkendelse returnerer 401
Ikke-synlige eller eksterne Workspaces returnerer 404

Fallback

Hvis qr3.app ikke finder et match, videresendes der til den overordnede GS1-resolver. Dette er vigtigt, for at trykte koder også fungerer, selvom et produkt endnu ikke er registreret lokalt.

Praksis

Opret DPP i dashboardet.
Brug GS1-URI’en som QR-destination.
Led forbrugende systemer til det ønskede format via Accept.