GS1 Digital Link resolver, objašnjen (uz primjer uživo)

Većina objašnjenja o QR kodovima za digitalnu putovnicu proizvoda staje na "skeniraj kod, otvori web stranicu". Time se propušta ono zanimljivo. QR kod na proizvodu koji je usklađen s propisima kodira GS1 Digital Link, a komponenta koja ga čini korisnim jest resolver — usluga koja jedan identifikator proizvoda pretvara u brojne različite, kontekstualno osviještene odgovore.

Ovaj članak pokazuje što resolver zapravo radi, uz putovnicu uživo koju možete pozvati već sada (bez registracije, bez ključa).

Što je GS1 Digital Link zapravo

GS1 Digital Link je obična HTTPS URL adresa koja ugrađuje GS1 identifikatore kao segmente putanje, pri čemu je svaki označen identifikatorom primjene (Application Identifier, AI):

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

01 → GTIN (Global Trade Item Number) — koji proizvod
21 → serijski broj — koja pojedinačna jedinica
10 → serija/lot (alternativa serijskom broju)

Budući da je riječ o običnoj URL adresi, otvara je kamera bilo kojeg telefona. Budući da je strukturirana, strojevi je mogu parsirati. Upravo je ta dvojna priroda cijela poanta.

Resolver: jedan URI, brojni odgovori

Glupi QR kod vraća jednu fiksnu stranicu. Resolver pregledava zahtjev i vraća prikaz koji odgovara pozivatelju:

potrošač s preglednikom na telefonu dobiva HTML stranicu čitljivu ljudima;
sustav reciklera traži JSON-LD i dobiva strukturirane podatke čitljive strojevima;
nadležno tijelo može zatražiti cjeloviti linkset — svaku tipiziranu poveznicu koju proizvod izlaže.

Ista URL adresa, različiti odgovori, određeni zaglavljem Accept (ili nadjačavanjem putem ?format=).

Resolver uživo koji možete pozvati već sada

qr3.app hosta javnu demo putovnicu baterije. Otvorite je u pregledniku:

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

Vidjet ćete potrošačku stranicu za EcoMax 5000 (Demo) tvrtke GreenPower GmbH. Sada od iste URL adrese zatražite strojno čitljiv 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 koji obavlja svoj posao: jedan identifikator, stranica za ljude i JSON-LD dokument izgrađen na schema.org + GS1 web rječniku. Drugi prikazi dostupni su na isti način — ?format=json (sirova putovnica), ?format=linkset (sve tipizirane poveznice), ?format=dcat-ap — ili putem standardne Accept pregovaranja (Accept: application/ld+json).

Provjerite identifikatore prije nego što kreirate poveznice

Resolver je pouzdan onoliko koliko su pouzdani identifikatori iza njega. Provjerite GTIN prije nego što za njega izgradite 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-ove

Držite pod kontrolom identifikatore koje koristite kako bi svaki Digital Link bio sljediv natrag do poznatog proizvoda:

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

Korištenje qr3 kao vašeg resolvera

Ne morate sami graditi i upravljati resolverom. Usmjerite QR kod svog proizvoda na Digital Link, hostajte putovnicu na qr3.app, a resolver će posluživati ispravan prikaz za svaki zahtjev. GTIN/serijski broj u URL adresi ostaju trajno stabilni (pa otisnute naljepnice nikada ne prestaju raditi), dok podaci iza njih ostaju mogući za ažuriranje.

Česta pitanja

Je li sam QR kod drugačiji od običnog? Nije — riječ je o standardnom QR-u (ili Data Matrixu) koji nosi URL adresu GS1 Digital Linka. Otvara ga svaka kamera; inteligencija je u resolveru, a ne u samom simbolu.

Dobivaju li potrošači i recikleri doista različit sadržaj? Da — to je pregovaranje o sadržaju. Preglednik dobiva HTML; sustav koji traži application/ld+json (ili ?format=jsonld) dobiva strukturirane podatke s iste URL adrese.

Mogu li zadržati vlastitu stranicu proizvoda i i dalje biti usklađen? Da. Digital Link može izložiti više tipiziranih poveznica (linkset) — vašu marketinšku stranicu, službenu putovnicu, podatkovni list za recikliranje — pri čemu je svaka označena vrstom poveznice.

Izvori

Isprobajte putovnicu uživo gore, zatim započnite besplatno i razriješite vlastitu.