Razlaga razreševalnika GS1 Digital Link (z živim primerom)

Večina razlag o QR kodah za digitalni potni list izdelka se ustavi pri »skenirajte kodo, odprite spletno stran«. S tem zgreši zanimivi del. QR koda na skladnem izdelku kodira GS1 Digital Link, komponenta, ki ga naredi uporabnega, pa je razreševalnik — storitev, ki en identifikator izdelka pretvori v številne različne, kontekstno odvisne odgovore.

Ta članek pokaže, kaj razreševalnik dejansko počne, z živim potnim listom, ki ga lahko pokličete prav zdaj (brez registracije, brez ključa).

Kaj GS1 Digital Link pravzaprav je

GS1 Digital Link je običajen URL HTTPS, ki vgrajuje identifikatorje GS1 kot segmente poti, vsakega označenega z aplikacijskim identifikatorjem (AI):

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

01 → GTIN (Global Trade Item Number) — kateri izdelek
21 → serijska številka — katera posamezna enota
10 → serija/lot (alternativa serijski številki)

Ker je navaden URL, ga odpre vsaka kamera telefona. Ker je strukturiran, ga znajo razčleniti tudi stroji. V tej dvojni naravi je celotno bistvo.

Razreševalnik: en URI, mnogo odgovorov

Neumna QR koda vrne eno fiksno stran. Razreševalnik pregleda zahtevo in vrne predstavitev, ki ustreza klicatelju:

potrošnik z brskalnikom na telefonu dobi človeku berljivo stran HTML;
sistem predelovalca odpadkov zahteva JSON-LD in dobi strojno berljive strukturirane podatke;
organ lahko zahteva celoten linkset — vsako tipizirano povezavo, ki jo izdelek izpostavlja.

Isti URL, različni odgovori, o čemer odloča glava Accept (ali preglasitev ?format=).

Živi razreševalnik, ki ga lahko pokličete prav zdaj

qr3.app gosti javni demonstracijski potni list baterije. Odprite ga v brskalniku:

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

Videli boste potrošniško stran za EcoMax 5000 (Demo) podjetja GreenPower GmbH. Zdaj zahtevajte isti URL v strojno berljivem 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 razreševalnik, ki opravlja svoje delo: en identifikator, človeku namenjena stran in dokument JSON-LD, zgrajen na schema.org + spletnem besednjaku GS1. Druge predstavitve so na voljo na enak način — ?format=json (surovi potni list), ?format=linkset (vse tipizirane povezave), ?format=dcat-ap — ali prek standardnega pogajanja z Accept (Accept: application/ld+json).

Preverite identifikatorje, preden ustvarite povezave

Razreševalnik je vreden le toliko, kolikor so zaupanja vredni identifikatorji za njim. Preverite GTIN, preden zanj zgradite 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"

Registrirajte svoje GTIN-e

Identifikatorje, ki jih uporabljate, imejte pod nadzorom, tako da je vsak Digital Link mogoče izslediti nazaj do znanega izdelka:

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

Uporaba qr3 kot vašega razreševalnika

Razreševalnika vam ni treba zgraditi in upravljati samostojno. Usmerite QR kodo izdelka na Digital Link, gostite potni list na qr3.app, razreševalnik pa za vsako zahtevo postreže s pravo predstavitvijo. GTIN/serijska številka v URL-ju ostaneta trajno stabilna (tako natisnjene etikete nikoli ne odpovedo), medtem ko podatki za njima ostanejo posodobljivi.

Pogosta vprašanja

Ali se sama QR koda razlikuje od običajne? Ne — gre za standardno QR (ali Data Matrix) kodo, ki nosi URL GS1 Digital Link. Odpre jo vsaka kamera; inteligenca je v razreševalniku, ne v simbolu.

Ali potrošniki in predelovalci odpadkov res dobijo različno vsebino? Da — to je pogajanje o vsebini. Brskalnik dobi HTML; sistem, ki zahteva application/ld+json (ali ?format=jsonld), dobi strukturirane podatke z istega URL-ja.

Ali lahko obdržim svojo izdelčno stran in sem še vedno skladen? Da. Digital Link lahko izpostavlja več tipiziranih povezav (linkset) — vašo marketinško stran, uradni potni list, podatkovni list za recikliranje — vsako označeno s tipom povezave.

Viri

Preizkusite živi potni list zgoraj, nato pa začnite brezplačno in razrešite svojega.