GS1 Digital Link Resolver vysvětlený (s živým příkladem)

Většina vysvětlení QR kódů digitálního produktového pasu (Digital Product Passport) končí u „naskenuj kód, otevři web". Tím ale uniká ta zajímavá část. QR kód na produktu odpovídajícím předpisům kóduje GS1 Digital Link a komponentou, která jej činí užitečným, je resolver — služba, která z jednoho identifikátoru produktu vytváří mnoho různých odpovědí přizpůsobených kontextu.

Tento článek ukazuje, co resolver ve skutečnosti dělá, na živém pasu, který si můžete hned teď zavolat (bez registrace, bez klíče).

Co je GS1 Digital Link doopravdy

GS1 Digital Link je běžná HTTPS URL, která vkládá identifikátory GS1 jako segmenty cesty, přičemž každý je označen Application Identifierem (AI):

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

01 → GTIN (Global Trade Item Number) — který produkt
21 → sériové číslo — která konkrétní jednotka
10 → šarže/dávka (alternativa k sériovému číslu)

Protože jde o čistou URL, otevře ji kamera libovolného telefonu. Protože je strukturovaná, dokážou ji parsovat stroje. Právě v této dvojí povaze je celý smysl.

Resolver: jedna URI, mnoho odpovědí

Hloupý QR kód vrací jednu pevnou stránku. Resolver prozkoumá požadavek a vrátí reprezentaci, která vyhovuje volajícímu:

spotřebitel s prohlížečem v telefonu dostane člověkem čitelnou HTML stránku;
systém recyklátora požádá o JSON-LD a dostane strojově čitelná strukturovaná data;
úřad si může vyžádat kompletní linkset — každý typovaný odkaz, který produkt zpřístupňuje.

Stejná URL, různé odpovědi, určené hlavičkou Accept (nebo přepsáním pomocí ?format=).

Živý resolver, který si můžete hned teď zavolat

qr3.app hostuje veřejné demo bateriového pasu. Otevřete jej v prohlížeči:

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

Uvidíte spotřebitelskou stránku produktu EcoMax 5000 (Demo) od GreenPower GmbH. Nyní požádejte stejnou URL o strojově čitelný 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 při své práci: jeden identifikátor, člověkem čitelná stránka a dokument JSON-LD postavený na schema.org + webovém slovníku GS1. Další reprezentace jsou dostupné stejným způsobem — ?format=json (surový pas), ?format=linkset (všechny typované odkazy), ?format=dcat-ap — nebo prostřednictvím standardního vyjednávání přes Accept (Accept: application/ld+json).

Ověřte identifikátory, než začnete razit odkazy

Resolver je jen tak důvěryhodný jako identifikátory, které za ním stojí. Než pro GTIN vytvoříte Digital Link, ověřte jej:

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 své GTINy

Udržujte identifikátory, které používáte, pod správou, aby každý Digital Link vedl zpět ke známému produktu:

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

Použití qr3 jako vašeho resolveru

Resolver si nemusíte stavět a provozovat sami. Nasměrujte QR kód svého produktu na Digital Link, hostujte pas na qr3.app a resolver pro každý požadavek poslouží správnou reprezentaci. GTIN/sériové číslo v URL zůstávají navždy stabilní (takže vytištěné štítky se nikdy nerozbijí), zatímco data za nimi zůstávají aktualizovatelná.

FAQ

Je samotný QR kód jiný než běžný? Ne — je to standardní QR (nebo Data Matrix) nesoucí URL GS1 Digital Link. Otevře jej libovolná kamera; inteligence je v resolveru, nikoli v symbolu.

Dostanou spotřebitelé a recyklátoři opravdu odlišný obsah? Ano — to je vyjednávání o obsahu. Prohlížeč dostane HTML; systém požadující application/ld+json (nebo ?format=jsonld) dostane ze stejné URL strukturovaná data.

Mohu si ponechat vlastní produktovou stránku a přesto být v souladu s předpisy? Ano. Digital Link může zpřístupnit více typovaných odkazů (linkset) — vaši marketingovou stránku, oficiální pas, recyklační datový list — každý označený typem odkazu.

Zdroje

Vyzkoušejte živý pas výše, poté začněte zdarma a vyřešte si svůj vlastní.