A GS1 Digital Link resolver, közérthetően (élő példával)

A digitális termékútlevél QR-kódjairól szóló magyarázatok többsége megáll annál, hogy „olvasd be a kódot, nyisd meg a weboldalt". Ez azonban kihagyja a lényeget. Egy szabványnak megfelelő terméken lévő QR-kód egy GS1 Digital Linket kódol, és az a komponens, amely hasznossá teszi, a resolver — az a szolgáltatás, amely egyetlen termékazonosítóból sokféle, kontextusfüggő választ készít.

Ez a cikk megmutatja, mit csinál valójában a resolver, egy élő útlevéllel, amelyet most azonnal lekérhetsz (regisztráció és kulcs nélkül).

Mi is valójában egy GS1 Digital Link

A GS1 Digital Link egy szokványos HTTPS URL, amely a GS1 azonosítókat útvonalszegmensekként ágyazza be, mindegyiket egy alkalmazásazonosítóval (Application Identifier, AI) megjelölve:

https://id.gs1.org/01/04019999999902/21/DEMO-BAT-01
                   └─01─┘ └──GTIN───┘ └21┘ └─serial─┘

01 → GTIN (Global Trade Item Number) — melyik termék
21 → sorozatszám — melyik egyedi darab
10 → tétel/gyártási szám (a sorozatszám alternatívája)

Mivel egyszerű URL, bármelyik telefon kamerája megnyitja. Mivel strukturált, a gépek értelmezni tudják. Ez a kettős természet a lényeg.

A resolver: egy URI, sok válasz

Egy buta QR-kód egyetlen rögzített oldalt ad vissza. Egy resolver megvizsgálja a kérést, és azt a reprezentációt adja vissza, amely a hívóhoz illik:

egy telefonos böngészőt használó fogyasztó ember által olvasható HTML-oldalt kap;
egy újrahasznosító rendszere JSON-LD-t kér, és gépileg feldolgozható, strukturált adatokat kap;
egy hatóság lekérheti a teljes linkset-et — minden típusos hivatkozást, amelyet a termék közzétesz.

Ugyanaz az URL, különböző válaszok, amelyekről az Accept fejléc dönt (vagy egy ?format= felülbírálás).

Egy élő resolver, amelyet most azonnal lekérhetsz

A qr3.app egy nyilvános demó akkumulátor-útlevelet üzemeltet. Nyisd meg böngészőben:

https://qr3.app/dpp/04019999999902/DEMO-BAT-01

Az EcoMax 5000 (Demo) fogyasztói oldalát fogod látni a GreenPower GmbH-tól. Most kérd le ugyanazt az URL-t gépileg feldolgozható JSON-LD formátumban:

curl "https://qr3.app/dpp/04019999999902/DEMO-BAT-01?format=jsonld"

{
  "@context": ["https://schema.org", "https://gs1.org/voc/"],
  "@type": "Product",
  "gtin": "04019999999902",
  "name": "EcoMax 5000 (Demo)"
}

Ez a resolver munkája: egy azonosító, egy emberi oldal és egy JSON-LD dokumentum, amely a schema.org-ra + a GS1 webes szótárra épül. Más reprezentációk ugyanígy elérhetők — ?format=json (nyers útlevél), ?format=linkset (minden típusos hivatkozás), ?format=dcat-ap — vagy szabványos Accept egyeztetéssel (Accept: application/ld+json).

Ellenőrizd az azonosítókat, mielőtt linkeket hoznál létre

Egy resolver csak annyira megbízható, mint a mögötte álló azonosítók. Ellenőrizz egy GTIN-t, mielőtt Digital Linket építenél hozzá:

import { QR3 } from "@qr3/sdk";

const client = new QR3({ apiKey: process.env.QR3_API_KEY! });

const result = await client.gs1.validateGs1({
  identifier_type: "gtin",
  value: "04019999999902",
});

console.log(result.valid);   // true
console.log(result.detail);  // "Valid GTIN-14"

Regisztráld a GTIN-jeidet

Tartsd kezelés alatt a használt azonosítókat, hogy minden Digital Link visszavezethető legyen egy ismert termékre:

const gtin = await client.gs1.createGs1Identifier({
  identifier_type: "gtin", // or "gln" | "company_prefix"
  value: "04019999999902",
  label: "EcoMax 5000",
});

A qr3 mint resolvered

Nem kell magadnak felépítened és üzemeltetned egy resolvert. Irányítsd a termék QR-kódját a Digital Linkre, üzemeltesd az útlevelet a qr3.app-on, és a resolver kérésenként a megfelelő reprezentációt szolgálja ki. Az URL-ben lévő GTIN/sorozatszám örökre stabil marad (így a kinyomtatott címkék soha nem törnek el), miközben a mögöttük lévő adatok frissíthetők maradnak.

GYIK

Maga a QR-kód különbözik egy normál QR-kódtól? Nem — ez egy szabványos QR (vagy Data Matrix), amely egy GS1 Digital Link URL-t hordoz. Bármelyik kamera megnyitja; az intelligencia a resolverben rejlik, nem a szimbólumban.

A fogyasztók és az újrahasznosítók valóban különböző tartalmat kapnak? Igen — ez a tartalomegyeztetés (content negotiation). A böngésző HTML-t kap; egy application/ld+json-t (vagy ?format=jsonld-t) kérő rendszer strukturált adatokat kap ugyanarról az URL-ről.

Megtarthatom a saját termékoldalamat, és mégis megfelelhetek az előírásoknak? Igen. A Digital Link több típusos hivatkozást is közzétehet (egy linkset-et) — a marketingoldalad, a hivatalos útlevél, egy újrahasznosítási adatlap — mindegyiket egy hivatkozástípussal megjelölve.

Források

Próbáld ki a fenti élő útlevelet, majd kezdd el ingyen, és oldd fel a sajátodat.