Razreševalnik GS1

Razreševalnik GS1 je javni bralni sloj za DPP. Kanonični URL je videti takole:

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}

Pri ustvarjanju DPP (POST /v1/dpp) veljajo naslednja pravila: serial in lot morata uporabljati varna segmenta poti GS1: samo A-Z, a-z, 0-9, ., _, ~, - in dolžino od 1 do 20 znakov. Rezervirana ločila URL so zavrnjena, da kanonična povezava ostane razrešljiva.

Pogajanje o vsebini

Isti razreševalnik glede na glavo Accept ponuja različne predstavitve:

Accept	Odgovor
`text/html`	HTML za potrošnike
`application/ld+json`	JSON-LD
`application/json`	Surov DPP-JSON
`application/linkset+json`	Nabor povezav z alternativami

Javno vidne poti

GET /01/... je kanonični razreševalnik
GET /dpp/:gtin/:serial?lot=... je vzdevek HTML
GET /v1/dpp/:id/qr.svg vrne SVG
GET /v1/dpp/:id/qr.png vrne PNG
GET /v1/dpp/:id/qr.pdf vrne PDF
GET /v1/dpp/:id/qr.eps vrne EPS

Vidnost QR-sredstev je odvisna od stanja DPP:

live je javno dostopen brez avtentikacije
draft in archived potrebujeta veljaven kontekst avtentikacije in dostop do delovnega prostora
Neveljavna avtentikacija vrne 401
Nevidni ali tuji delovni prostori vrnejo 404

Rezervno delovanje

Če ni lokalnega ujemanja, razreševalnik GS1 preusmeri zahtevo s kodo 307 na https://id.gs1.org. Za vzdevek GTIN /dpp/:gtin/:serial?lot=... to velja tudi pri neveljavni kontrolni številki GTIN: gtin, lot in serial se ločeno kodirajo kot segmenti poti URL, vključno z rezerviranimi ločili. Preusmeritev ne potrjuje veljavnosti GTIN ali razpoložljivosti podatkov pri GS1.

Izjema: če je dekodiran identifikator samo . ali .., vzdevek brez lokalnega ujemanja odgovori s kodo 422, obliko application/problem+json, tipom https://docs.qr3.app/errors/validation in zadevnim poljem v errors[], brez preusmeritve. Razčlenjevalniki URL normalizirajo te segmente tudi v kodirani obliki. Vrednosti, kot sta LOT.1 in ..., je še vedno mogoče posredovati. Izjema velja samo za ta vzdevek brez ujemanja; preverjanje pri ustvarjanju, kanonični razreševalnik in obstoječa ujemanja ostanejo nespremenjeni.

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

Praksa

Ustvarite DPP na nadzorni plošči.
Uporabite URI GS1 kot cilj QR.
Odjemalske sisteme prek glave Accept usmerite na želeno obliko.