Skip to content
qr3.app Docs

GS1-Resolver

GS1-Resolver

GS1-Resolver je javni sloj za čitanje za DPP. Kanonska URL adresa izgleda ovako:

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 i lot moraju koristiti sigurne segmente GS1 putanje: samo A-Z, a-z, 0-9, ., _, ~, - i duljinu od 1 do 20 znakova. Rezervirani URL separatori se odbijaju kako bi kanonska poveznica ostala razrješiva.

Content Negotiation

Isti razrješivač pruža različite prikaze ovisno o zaglavlju Accept:

AcceptOdgovor
text/htmlKorisnički HTML
application/ld+jsonJSON-LD
application/jsonSirovi DPP JSON
application/linkset+jsonSkup poveznica (Linkset) s alternativama

Javno vidljive rute

  • GET /01/... je kanonski razrješivač
  • GET /dpp/:gtin/:serial?lot=... je HTML alias
  • GET /v1/dpp/:id/qr.svg vraća SVG
  • GET /v1/dpp/:id/qr.png vraća PNG
  • GET /v1/dpp/:id/qr.pdf vraća PDF
  • GET /v1/dpp/:id/qr.eps vraća EPS

Vidljivost QR resursa ovisi o statusu DPP-a:

  • live je javno dostupan bez autentifikacije
  • draft i archived zahtijevaju valjani autentifikacijski kontekst i pristup radnom prostoru (Workspace)
  • Nevaljana autentifikacija vraća 401
  • Nevidljivi ili tuđi radni prostori (Workspaces) vraćaju 404

Fallback

Ako qr3.app ne pronađe podudaranje, preusmjerava se na nadređeni GS1-Resolver. To je važno kako bi tiskani kodovi radili čak i ako proizvod još nije lokalno registriran.

Praksa

  1. Izradite DPP na upravljačkoj ploči (Dashboard).
  2. Koristite GS1 URI kao QR odredište.
  3. Usmjerite klijentske sustave na željeni format pomoću zaglavlja Accept.