GS1-Resolver

GS1-Resolver

A GS1-Resolver a DPP nyilvános olvasási rétege. A kanonikus URL így néz ki:

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}

DPP létrehozásakor (POST /v1/dpp) a következő szabályok érvényesek: A serial és lot értékeknek biztonságos GS1 útvonalszegmenseket kell használniuk: csak A-Z, a-z, 0-9, ., _, ~, - karaktereket, és a hosszuk 1-től 20 karakterig terjedhet. A fenntartott URL-elválasztó karakterek elutasításra kerülnek, hogy a kanonikus link feloldható maradjon.

Content Negotiation

Ugyanaz a feloldó az Accept fejléc függvényében különböző reprezentációkat ad vissza:

Accept	Válasz
text/html	Fogyasztói HTML
application/ld+json	JSON-LD
application/json	Nyers DPP JSON
application/linkset+json	Linkset alternatívákkal

Nyilvánosan elérhető útvonalak

• GET /01/... a kanonikus feloldó (resolver)
• GET /dpp/:gtin/:serial?lot=... egy HTML álnév (alias)
• GET /v1/dpp/:id/qr.svg visszaadja az SVG-t
• GET /v1/dpp/:id/qr.png visszaadja a PNG-t
• GET /v1/dpp/:id/qr.pdf visszaadja a PDF-et
• GET /v1/dpp/:id/qr.eps visszaadja az EPS-t

A QR-eszközök (assets) láthatósága a DPP állapotától függ:

• A live hitelesítés nélkül, nyilvánosan elérhető
• A draft és archived állapotokhoz érvényes hitelesítési kontextus (Auth) és Workspace-hozzáférés szükséges
• Érvénytelen hitelesítés esetén 401 választ ad
• A nem látható vagy idegen Workspace-ek 404 választ adnak

Fallback

Ha nincs helyi egyezés, a GS1-feloldó 307 kóddal átirányít a https://id.gs1.org címre. A /dpp/:gtin/:serial?lot=... GTIN-alias esetében ez érvénytelen GTIN-ellenőrző számjegynél is érvényes: a gtin, lot és serial külön URL-útvonalszegmensként kerül kódolásra, a fenntartott elválasztókat is beleértve. Az átirányítás nem igazolja a GTIN érvényességét vagy az adatok elérhetőségét a GS1-nél.

Kivétel: ha egy dekódolt azonosító kizárólag . vagy .., a helyi egyezés nélküli alias 422 kóddal, application/problem+json formátummal, https://docs.qr3.app/errors/validation típussal és az érintett mezővel válaszol az errors[] listában, átirányítás nélkül. Az URL-feldolgozók ezeket a szegmenseket kódolt formában is normalizálják. A LOT.1 és ... értékek továbbra is továbbíthatók. A kivétel csak erre az egyezés nélküli aliasra vonatkozik; a létrehozási validáció, a kanonikus feloldó és a meglévő egyezések változatlanok.

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

Gyakorlati alkalmazás

1. Hozd létre a DPP-t az irányítópulton (Dashboard).
2. Használd a GS1 URI-t QR-célként.
3. Irányítsd a fogyasztó rendszereket a kívánt formátumra az Accept fejléc segítségével.