GS1 Resolver

GS1 Resolver yra viešasis DPP skaitymo sluoksnis. Kanoninis URL atrodo taip:

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 ir lot privalo naudoti saugius GS1 kelio segmentus: tik A-Z, a-z, 0-9, ., _, ~, - ir ilgis nuo 1 iki 20 simbolių. Rezervuoti URL skirtukai yra atmetami, kad kanoninė nuoroda išliktų atpažįstama.

Turinio derybos (Content Negotiation)

Tas pats atpažintuvas, priklausomai nuo Accept antraštės, pateikia skirtingas reprezentacijas:

Accept	Atsakymas
`text/html`	Vartotojo HTML
`application/ld+json`	JSON-LD
`application/json`	Grynasis DPP JSON
`application/linkset+json`	Nuorodų rinkinys (Linkset) su alternatyvomis

Viešai matomi maršrutai

GET /01/... yra kanoninis atpažintuvas
GET /dpp/:gtin/:serial?lot=... yra HTML pseudonimas (alias)
GET /v1/dpp/:id/qr.svg pateikia SVG
GET /v1/dpp/:id/qr.png pateikia PNG
GET /v1/dpp/:id/qr.pdf pateikia PDF
GET /v1/dpp/:id/qr.eps pateikia EPS

QR išteklių matomumas priklauso nuo DPP būsenos:

live yra viešai pasiekiamas be autentifikavimo
draft ir archived reikalauja galiojančio autentifikavimo konteksto ir prieigos prie Workspace
Neteisingas autentifikavimas grąžina 401
Nematomi arba svetimi Workspaces grąžina 404

Atsarginis veikimas (Fallback)

Jei qr3.app neranda atitikmens, užklausa nukreipiama į aukštesnio lygio GS1 Resolver. Tai svarbu, kad atspausdinti kodai veiktų net ir tada, kai produktas dar nėra užregistruotas lokaliai.

Praktika

Sukurkite DPP valdymo skydelyje (Dashboard).
Naudokite GS1 URI kaip QR tikslą.
Nukreipkite vartojančias sistemas į pageidaujamą formatą per Accept antraštę.