GS1-Resolver

GS1-Resolver je veřejná vrstva pro čtení DPP. Kanonická URL vypadá takto:

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 a lot musí používat bezpečné segmenty cesty GS1: pouze A-Z, a-z, 0-9, ., _, ~, - a délku 1 až 20 znaků. Vyhrazené oddělovače URL jsou odmítnuty, aby kanonický odkaz zůstal rozlišitelný.

Content Negotiation

Stejný resolver poskytuje různé reprezentace v závislosti na hlavičce Accept:

Accept	Odpověď
`text/html`	Spotřebitelské HTML
`application/ld+json`	JSON-LD
`application/json`	Surové DPP-JSON
`application/linkset+json`	Linkset s alternativami

Veřejně viditelné trasy

GET /01/... je kanonický resolver
GET /dpp/:gtin/:serial?lot=... je HTML alias
GET /v1/dpp/:id/qr.svg vrací SVG
GET /v1/dpp/:id/qr.png vrací PNG
GET /v1/dpp/:id/qr.pdf vrací PDF
GET /v1/dpp/:id/qr.eps vrací EPS

Viditelnost QR aktiv se řídí stavem DPP:

live je veřejně dostupný bez autentizace
draft a archived vyžadují platný kontext ověření (auth kontext) a přístup k pracovnímu prostoru (Workspace)
Neplatná autentizace vrací 401
Neviditelné nebo cizí pracovní prostory (Workspaces) vrací 404

Fallback

Pokud qr3.app nenajde žádnou shodu, dojde k přesměrování na nadřazený GS1-Resolver. To je důležité, aby vytištěné kódy fungovaly i v případě, že produkt ještě není lokálně registrován.

Praxe

Vytvořte DPP v administraci (Dashboard).
Použijte GS1 URI jako cíl QR kódu.
Nasměrujte klientské systémy na požadovaný formát pomocí hlavičky Accept.