GS1 resolver

GS1 resolver je verejná vrstva na čítanie pre DPP. Kanonická URL vyzerá 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 musia používať bezpečné segmenty cesty GS1: iba A-Z, a-z, 0-9, ., _, ~, - a dĺžku od 1 do 20 znakov. Vyhradené oddeľovače URL sú odmietnuté, aby kanonický odkaz zostal rozlíšiteľný.

Content Negotiation

Rovnaký resolver poskytuje rôzne reprezentácie v závislosti od hlavičky Accept:

Accept	Odpoveď
`text/html`	Spotrebiteľské HTML
`application/ld+json`	JSON-LD
`application/json`	Surové DPP JSON
`application/linkset+json`	Linkset s alternatívami

Verejne viditeľné trasy

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

Viditeľnosť QR assetov závisí od stavu DPP:

live je verejne dostupný bez autentifikácie
draft a archived vyžadujú platný kontext autentifikácie (Auth) a prístup k workspace
Neplatná autentifikácia vracia 401
Neviditeľné alebo cudzie workspace-y vracajú 404

Fallback

Ak qr3.app nenájde žiadnu zhodu, požiadavka sa presmeruje na nadradený GS1 resolver. To je dôležité, aby vytlačené kódy fungovali aj vtedy, keď produkt ešte nie je lokálne zaregistrovaný.

Prax

Vytvorte DPP v paneli (Dashboard).
Použite GS1 URI ako cieľ QR kódu.
Presmerujte klientske systémy na požadovaný formát pomocou hlavičky Accept.