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:
| Accept | Răspuns |
|---|---|
text/html | HTML pentru consumatori |
application/ld+json | JSON-LD |
application/json | JSON DPP brut |
application/linkset+json | Linkset cu alternative |
Rute vizibile public
GET /01/...este resolverul canonicGET /dpp/:gtin/:serial?lot=...este un alias HTMLGET /v1/dpp/:id/qr.svgreturnează SVG-ulGET /v1/dpp/:id/qr.pngreturnează PNG-ulGET /v1/dpp/:id/qr.pdfreturnează PDF-ulGET /v1/dpp/:id/qr.epsreturnează EPS-ul
Vizibilitatea activelor QR depinde de starea DPP:
liveeste accesibil public fără autentificaredraftșiarchivednecesită 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ă
- Creați DPP în panoul de control (dashboard).
- Utilizați URI-ul GS1 ca țintă pentru codul QR.
- Direcționați sistemele consumatoare către formatul dorit utilizând antetul
Accept.