Resolver GS1

Resolver GS1 to publiczna warstwa odczytu dla DPP. Kanoniczny adres URL wygląda następująco:

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 i lot muszą używać bezpiecznych segmentów ścieżki GS1: tylko A-Z, a-z, 0-9, ., _, ~, - oraz długość od 1 do 20 znaków. Zarezerwowane separatory adresów URL są odrzucane, aby link kanoniczny pozostał możliwy do rozwiązania.

Negocjacja zawartości

Ten sam resolver dostarcza różne reprezentacje w zależności od nagłówka Accept:

Accept	Odpowiedź
`text/html`	HTML dla konsumenta
`application/ld+json`	JSON-LD
`application/json`	Surowy DPP-JSON
`application/linkset+json`	Zbiór linków (Linkset) z alternatywami

Trasy widoczne publicznie

GET /01/... to kanoniczny resolver
GET /dpp/:gtin/:serial?lot=... to alias HTML
GET /v1/dpp/:id/qr.svg zwraca SVG
GET /v1/dpp/:id/qr.png zwraca PNG
GET /v1/dpp/:id/qr.pdf zwraca PDF
GET /v1/dpp/:id/qr.eps zwraca EPS

Widoczność zasobów QR zależy od statusu DPP:

live jest publicznie dostępny bez uwierzytelniania
draft i archived wymagają ważnego kontekstu uwierzytelniania oraz dostępu do obszaru roboczego (Workspace)
Nieprawidłowe uwierzytelnienie zwraca 401
Niewidoczne lub należące do innych podmiotów obszary robocze (Workspaces) zwracają 404

Fallback

Jeśli qr3.app nie znajdzie dopasowania, następuje przekierowanie do nadrzędnego resolvera GS1. Jest to ważne, aby wydrukowane kody działały nawet wtedy, gdy produkt nie jest jeszcze zarejestrowany lokalnie.

W praktyce

Utwórz DPP w panelu nawigacyjnym (Dashboard).
Użyj identyfikatora URI GS1 jako celu kodu QR.
Skieruj systemy konsumujące na żądany format za pomocą nagłówka Accept.