GS1 Резолвер

GS1 Резолверът е публичният слой за четене на DPP. Каноничният URL адрес изглежда така:

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 и lot трябва да използват сигурни сегменти от пътя на GS1: само A-Z, a-z, 0-9, ., _, ~, - и дължина от 1 до 20 знака. Резервираните URL разделители се отхвърлят, за да може каноничната връзка да остане разрешима.

Content Negotiation

Същият резолвер предоставя различни представяния в зависимост от заглавната част Accept:

Accept	Отговор
`text/html`	Consumer-HTML
`application/ld+json`	JSON-LD
`application/json`	Суров DPP-JSON
`application/linkset+json`	Linkset с алтернативи

Публично достъпни маршрути

GET /01/... е каноничният резолвер
GET /dpp/:gtin/:serial?lot=... е HTML псевдоним
GET /v1/dpp/:id/qr.svg връща SVG
GET /v1/dpp/:id/qr.png връща PNG
GET /v1/dpp/:id/qr.pdf връща PDF
GET /v1/dpp/:id/qr.eps връща EPS

Видимостта на QR активите зависи от статуса на DPP:

live е публично достъпен без автентикация
draft и archived изискват валиден контекст за автентикация плюс достъп до Workspace
Невалидната автентикация връща 401
Невидимите или чуждите Workspaces връщат 404

Fallback

Ако qr3.app не намери съвпадение, се пренасочва към родителския GS1 резолвер. Това е важно, за да могат отпечатаните кодове да работят дори ако даден продукт все още не е регистриран локално.

Практика

Създайте DPP в таблото за управление (Dashboard).
Използвайте GS1 URI като цел на QR кода.
Насочете консумиращите системи към желания формат чрез Accept.