Sari la conținut

GS1-Resolver

GS1-Resolver

GS1-Resolver este stratul public de citire pentru un DPP. URL-ul canonic arată astfel:

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 trebuie să utilizeze segmente de cale GS1 sigure: doar A-Z, a-z, 0-9, ., _, ~, - și o lungime de la 1 până la 20 de caractere. Delimitatorii URL rezervați sunt respinși pentru ca linkul canonic să rămână rezolvabil.

Content Negotiation

Același resolver oferă reprezentări diferite în funcție de antetul Accept:

AcceptRăspuns
text/htmlHTML pentru consumatori
application/ld+jsonJSON-LD
application/jsonJSON DPP brut
application/linkset+jsonLinkset cu alternative

Rute vizibile public

  • GET /01/... este resolverul canonic
  • GET /dpp/:gtin/:serial?lot=... este un alias HTML
  • GET /v1/dpp/:id/qr.svg returnează SVG-ul
  • GET /v1/dpp/:id/qr.png returnează PNG-ul
  • GET /v1/dpp/:id/qr.pdf returnează PDF-ul
  • GET /v1/dpp/:id/qr.eps returnează EPS-ul

Vizibilitatea activelor QR depinde de starea DPP:

  • live este accesibil public fără autentificare
  • draft și archived necesită un context de autentificare valid plus acces la spațiul de lucru (workspace)
  • Autentificarea nevalidă returnează 401
  • Spațiile de lucru (workspaces) invizibile sau străine returnează 404

Fallback

Dacă qr3.app nu găsește nicio potrivire, cererea este redirecționată către resolverul GS1 părinte. Acest lucru este important pentru ca codurile imprimate să funcționeze chiar și atunci când un produs nu este încă înregistrat local.

În practică

  1. Creați DPP în panoul de control (dashboard).
  2. Utilizați URI-ul GS1 ca țintă pentru codul QR.
  3. Direcționați sistemele consumatoare către formatul dorit utilizând antetul Accept.