GS1 atrisinātājs

GS1 atrisinātājs ir publiskais nolasīšanas slānis priekš DPP. Kanoniskais URL izskatās šādi:

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}

Veidojot DPP (POST /v1/dpp), tiek piemēroti šādi noteikumi: serial un lot jāizmanto droši GS1 ceļa segmenti: tikai A-Z, a-z, 0-9, ., _, ~, - un garums no 1 līdz 20 rakstzīmēm. Rezervētie URL atdalītāji tiek noraidīti, lai kanoniskā saite paliktu atrisināma.

Satura saskaņošana

Tas pats atrisinātājs atkarībā no Accept galvenes nodrošina dažādus attēlojumus:

Accept	Atbilde
`text/html`	Patērētāja HTML
`application/ld+json`	JSON-LD
`application/json`	Neapstrādāts DPP JSON
`application/linkset+json`	Linkset ar alternatīvām

Publiski redzamie maršruti

GET /01/... ir kanoniskais atrisinātājs
GET /dpp/:gtin/:serial?lot=... ir HTML aizstājvārds
GET /v1/dpp/:id/qr.svg atgriež SVG
GET /v1/dpp/:id/qr.png atgriež PNG
GET /v1/dpp/:id/qr.pdf atgriež PDF
GET /v1/dpp/:id/qr.eps atgriež EPS

QR resursu redzamība ir atkarīga no DPP statusa:

live ir publiski pieejams bez autentifikācijas
draft un archived nepieciešams derīgs autentifikācijas konteksts un piekļuve darba videi (Workspace)
Nederīga autentifikācija atgriež 401
Neredzamas vai svešas darba vides atgriež 404

Rezerves darbība

Ja nav vietējas atbilstības, GS1 atrisinātājs pāradresē ar 307 uz https://id.gs1.org. GTIN aizstājējceļam /dpp/:gtin/:serial?lot=... tas attiecas arī uz nederīgu GTIN kontrolciparu: gtin, lot un serial tiek atsevišķi kodēti kā URL ceļa segmenti, ieskaitot rezervētos atdalītājus. Pāradresācija neapstiprina GTIN derīgumu vai datu pieejamību GS1.

Izņēmums: ja dekodētais identifikators ir tikai . vai .., aizstājējceļš bez vietējas atbilstības atbild ar 422, application/problem+json, tipu https://docs.qr3.app/errors/validation un attiecīgo lauku sarakstā errors[], bez pāradresācijas. URL parsētāji normalizē šos segmentus arī kodētā formā. Vērtības, piemēram, LOT.1 un ..., joprojām var pārsūtīt. Izņēmums attiecas tikai uz šo ceļu bez atbilstības; izveides validācija, kanoniskais atrisinātājs un esošās atbilstības nemainās.

GET /dpp/{GTIN}/UNKNOWN?lot=LOT%2F1
307 Location: https://id.gs1.org/01/{GTIN}/10/LOT%2F1/21/UNKNOWN

GET /dpp/{GTIN}/UNKNOWN?lot=.
422 Content-Type: application/problem+json

Prakse

Izveidojiet DPP vadības panelī (Dashboard).
Izmantojiet GS1 URI kā QR mērķi.
Novirziet patērējošās sistēmas uz vēlamo formātu, izmantojot Accept.