Resolver tal-GS1

Ir-Resolver tal-GS1 huwa s-saff tal-qari pubbliku għal DPP. Il-URL kanonika tidher hekk:

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 u lot għandhom jużaw segmenti ta’ mogħdija siguri tal-GS1: biss A-Z, a-z, 0-9, ., _, ~, - u tul ta’ bejn karattru 1 u 20 karattru. Separaturi tal-URL riżervati jiġu rrifjutati sabiex il-link kanoniku jibqa’ jissolva.

Content Negotiation

L-istess resolver jipprovdi rappreżentazzjonijiet differenti skont l-header Accept:

Accept	Rispons
`text/html`	HTML tal-Konsumatur
`application/ld+json`	JSON-LD
`application/json`	DPP-JSON mhux ipproċessat
`application/linkset+json`	Linkset b’alternattivi

Rotot viżibbli pubblikament

GET /01/... huwa r-resolver kanoniku
GET /dpp/:gtin/:serial?lot=... huwa alias tal-HTML
GET /v1/dpp/:id/qr.svg jipprovdi s-SVG
GET /v1/dpp/:id/qr.png jipprovdi l-PNG
GET /v1/dpp/:id/qr.pdf jipprovdi l-PDF
GET /v1/dpp/:id/qr.eps jipprovdi l-EPS

Il-viżibbiltà tal-assi tal-QR tiddependi fuq l-istatus tad-DPP:

live huwa aċċessibbli pubblikament mingħajr awtentikazzjoni
draft u archived jeħtieġu kuntest ta’ awtentikazzjoni validu flimkien ma’ aċċess għall-Workspace
Awtentikazzjoni invalida tirritorna 401
Workspaces mhux viżibbli jew ta’ ħaddieħor jirritornaw 404

Fallback

Jekk qr3.app ma jsib l-ebda qbil, dan jiġi ridirezzjonat lejn ir-resolver tal-GS1 prinċipali. Dan huwa importanti sabiex il-kodiċijiet stampati jaħdmu anke jekk prodott ma jkunx għadu rreġistrat lokalment.

Fil-Prattika

Oħloq DPP fid-Dashboard.
Uża l-URI tal-GS1 bħala d-destinazzjoni tal-QR.
Idderieġi s-sistemi li jikkunsmaw lejn il-format mixtieq permezz ta’ Accept.