GS1 Digital Link Resolver – vysvetlenie (so živým príkladom)

Väčšina vysvetlení o QR kódoch pre digitálny produktový pas (Digital Product Passport) sa zastaví pri tom, že „naskenujete kód, otvorí sa webstránka". To však vynecháva tú najzaujímavejšiu časť. QR kód na produkte spĺňajúcom predpisy kóduje GS1 Digital Link a komponent, ktorý ho robí užitočným, je resolver – služba, ktorá premieňa jeden identifikátor produktu na množstvo rôznych, kontextovo zameraných odpovedí.

Tento článok ukazuje, čo resolver v skutočnosti robí, so živým passportom, ktorý môžete zavolať hneď teraz (bez registrácie, bez kľúča).

Čo je vlastne GS1 Digital Link

GS1 Digital Link je bežná HTTPS URL, ktorá vkladá identifikátory GS1 ako segmenty cesty, pričom každý je označený aplikačným identifikátorom (Application Identifier, AI):

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

01 → GTIN (Global Trade Item Number) — ktorý produkt
21 → sériové číslo — ktorý konkrétny kus
10 → šarža/dávka (alternatíva k sériovému číslu)

Keďže ide o obyčajnú URL, otvorí ju kamera ktoréhokoľvek telefónu. Keďže je štruktúrovaná, dokážu ju spracovať aj stroje. Práve táto dvojaká povaha je celý zmysel.

Resolver: jedna URI, mnoho odpovedí

Hlúpy QR kód vráti jednu pevnú stránku. Resolver preskúma požiadavku a vráti reprezentáciu, ktorá vyhovuje volajúcemu:

spotrebiteľ s prehliadačom v telefóne dostane ľudsky čitateľnú HTML stránku;
systém recyklátora si vyžiada JSON-LD a dostane strojovo čitateľné štruktúrované dáta;
úrad si môže vyžiadať celý linkset – každý typovaný odkaz, ktorý produkt sprístupňuje.

Rovnaká URL, rôzne odpovede, o ktorých rozhoduje hlavička Accept (alebo prepísanie pomocou ?format=).

Živý resolver, ktorý môžete zavolať hneď teraz

qr3.app hostuje verejné demo produktového pasu pre batériu. Otvorte ho v prehliadači:

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

Uvidíte spotrebiteľskú stránku produktu EcoMax 5000 (Demo) od spoločnosti GreenPower GmbH. Teraz si rovnakú URL vyžiadajte v strojovo čitateľnom formáte JSON-LD:

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)"
}

To je resolver pri práci: jeden identifikátor, ľudská stránka aj dokument JSON-LD postavený na schema.org + webovom slovníku GS1. Ďalšie reprezentácie sú dostupné rovnakým spôsobom – ?format=json (surový passport), ?format=linkset (všetky typované odkazy), ?format=dcat-ap – alebo prostredníctvom štandardnej negociácie cez Accept (Accept: application/ld+json).

Overte identifikátory predtým, než vytvoríte odkazy

Resolver je dôveryhodný len natoľko, nakoľko sú dôveryhodné identifikátory za ním. Overte GTIN predtým, než pre neho vytvoríte Digital Link:

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"

Zaregistrujte svoje GTIN

Udržujte identifikátory, ktoré používate, pod správou, aby každý Digital Link viedol späť k známemu produktu:

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

Použitie qr3 ako vášho resolvera

Resolver si nemusíte budovať a prevádzkovať sami. Nasmerujte QR kód svojho produktu na Digital Link, hostujte passport na qr3.app a resolver pre každú požiadavku poskytne tú správnu reprezentáciu. GTIN/sériové číslo v URL zostávajú navždy stabilné (takže vytlačené štítky sa nikdy nepokazia), zatiaľ čo dáta za nimi zostávajú aktualizovateľné.

Často kladené otázky

Líši sa samotný QR kód od bežného? Nie – je to štandardný QR (alebo Data Matrix) nesúci URL adresu GS1 Digital Link. Otvorí ho ktorákoľvek kamera; inteligencia je v resolveri, nie v symbole.

Dostávajú spotrebitelia a recyklátori naozaj rozdielny obsah? Áno – to je negociácia obsahu. Prehliadač dostane HTML; systém vyžadujúci application/ld+json (alebo ?format=jsonld) dostane štruktúrované dáta z rovnakej URL.

Môžem si ponechať vlastnú produktovú stránku a stále spĺňať predpisy? Áno. Digital Link môže sprístupniť viacero typovaných odkazov (linkset) – vašu marketingovú stránku, oficiálny passport, recyklačný technický list – pričom každý je označený typom odkazu.

Zdroje

Vyskúšajte živý passport vyššie a potom začnite zadarmo a vyriešte svoj vlastný.