Resolver tal-GS1

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}

Meta jinħoloq DPP (POST /v1/dpp), japplikaw dawn ir-regoli: 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

Mingħajr qbil lokali, ir-resolver GS1 jirridirezzjona b’307 lejn https://id.gs1.org. Għall-alias GTIN /dpp/:gtin/:serial?lot=..., dan japplika wkoll għal ċifra ta’ kontroll GTIN invalida: gtin, lot u serial jiġu kkodifikati separatament bħala segmenti tal-mogħdija URL, inklużi separaturi riżervati. Ir-ridirezzjoni ma tikkonfermax il-validità tal-GTIN jew id-disponibbiltà tad-data fil-GS1.

Eċċezzjoni: jekk identifikatur dekodifikat ikun biss . jew .., l-alias mingħajr qbil lokali jirrispondi b’422, application/problem+json, it-tip https://docs.qr3.app/errors/validation u l-kamp affettwat f’errors[], mingħajr ridirezzjoni. Il-parsers tal-URL jinnormalizzaw dawn is-segmenti anke meta jkunu kkodifikati. Valuri bħal LOT.1 u ... xorta jistgħu jintbagħtu. L-eċċezzjoni tapplika biss għal dan l-alias mingħajr qbil; il-validazzjoni tal-ħolqien, ir-resolver kanoniku u l-qbil eżistenti jibqgħu l-istess.

GET /dpp/{GTIN}/UNKNOWN?lot=LOT%2F1
307 Location: https://id.gs1.org/01/{GTIN}/10/LOT%2F1/21/UNKNOWN

GET /dpp/{GTIN}/UNKNOWN?lot=.
422 Content-Type: application/problem+json

Fil-Prattika

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