Skip to content

Razreševalnik GS1

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}

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:

AcceptOdgovor
text/htmlHTML za potrošnike
application/ld+jsonJSON-LD
application/jsonSurov DPP-JSON
application/linkset+jsonNabor 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 qr3.app ne najde ujemanja, se zahteva preusmeri na nadrejeni razreševalnik GS1. To je pomembno, da natisnjene kode delujejo tudi takrat, ko izdelek še ni lokalno registriran.

Praksa

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