GS1 Digital Link sprendiklis paprastai (su gyvu pavyzdžiu)

Dauguma paaiškinimų apie Skaitmeninio gaminio paso QR kodus sustoja ties „nuskaityk kodą, atsidaryk svetainę". Tačiau taip praleidžiama įdomiausia dalis. Reikalavimus atitinkančio gaminio QR kode užkoduotas GS1 Digital Link, o komponentas, paverčiantis jį naudingu, yra sprendiklis – paslauga, kuri vieną gaminio identifikatorių paverčia daugybe skirtingų, konteksto požiūriu pritaikytų atsakymų.

Šiame straipsnyje parodoma, ką sprendiklis iš tikrųjų daro, su gyvu pasu, kurį galite iškart iškviesti (be registracijos, be rakto).

Kas iš tikrųjų yra GS1 Digital Link

GS1 Digital Link yra įprastas HTTPS URL adresas, į kurį GS1 identifikatoriai įterpiami kaip kelio segmentai, kiekvienas pažymėtas taikymo identifikatoriumi (Application Identifier, AI):

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

01 → GTIN (Global Trade Item Number) – kuris gaminys
21 → serijos numeris – kuris konkretus vienetas
10 → partija (alternatyva serijos numeriui)

Kadangi tai paprastas URL adresas, jį atveria bet kurio telefono kamera. Kadangi jis struktūrizuotas, mašinos gali jį analizuoti. Būtent ši dvejopa prigimtis ir yra esmė.

Sprendiklis: vienas URI, daug atsakymų

Paprastas QR kodas grąžina vieną fiksuotą puslapį. Sprendiklis patikrina užklausą ir grąžina iškvietėjui tinkamą atvaizdavimą:

vartotojas su telefono naršykle gauna žmogui skaitomą HTML puslapį;
perdirbėjo sistema prašo JSON-LD ir gauna mašinai skaitomus struktūrizuotus duomenis;
institucija gali užklausti viso linkset – kiekvienos tipizuotos nuorodos, kurią gaminys atskleidžia.

Tas pats URL adresas, skirtingi atsakymai, sprendžiami pagal Accept antraštę (arba ?format= perrašymą).

Gyvas sprendiklis, kurį galite iškart iškviesti

qr3.app talpina viešą demonstracinį baterijos pasą. Atidarykite jį naršyklėje:

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

Pamatysite vartotojo puslapį apie EcoMax 5000 (Demo) iš GreenPower GmbH. Dabar paprašykite to paties URL mašinai skaitomo 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)"
}

Štai sprendiklis atliekantis savo darbą: vienas identifikatorius, žmogui skirtas puslapis ir JSON-LD dokumentas, sukurtas remiantis schema.org + GS1 žiniatinklio žodynu. Kiti atvaizdavimai pasiekiami tuo pačiu būdu – ?format=json (neapdorotas pasas), ?format=linkset (visos tipizuotos nuorodos), ?format=dcat-ap – arba per standartinį Accept derinimą (Accept: application/ld+json).

Patikrinkite identifikatorius prieš kurdami nuorodas

Sprendiklis tik tiek patikimas, kiek patikimi už jo esantys identifikatoriai. Patikrinkite GTIN prieš kurdami jam 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"

Užregistruokite savo GTIN numerius

Valdykite naudojamus identifikatorius, kad kiekvienas Digital Link būtų atsekamas iki žinomo gaminio:

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

qr3 naudojimas kaip jūsų sprendiklio

Jums nereikia patiems kurti ir eksploatuoti sprendiklio. Nukreipkite savo gaminio QR kodą į Digital Link, talpinkite pasą qr3.app, ir sprendiklis kiekvienai užklausai pateiks tinkamą atvaizdavimą. URL adrese esantys GTIN/serijos numeris išlieka stabilūs amžinai (todėl atspausdintos etiketės niekada nesugenda), o duomenys už jų lieka atnaujinami.

DUK

Ar pats QR kodas skiriasi nuo įprasto? Ne – tai standartinis QR (arba Data Matrix) kodas, nešantis GS1 Digital Link URL adresą. Jį atveria bet kuri kamera; intelektas slypi sprendiklyje, o ne pačiame simbolyje.

Ar vartotojai ir perdirbėjai tikrai gauna skirtingą turinį? Taip – tai turinio derinimas. Naršyklė gauna HTML; sistema, prašanti application/ld+json (arba ?format=jsonld), iš to paties URL adreso gauna struktūrizuotus duomenis.

Ar galiu išlaikyti savo nuosavą gaminio puslapį ir vis tiek atitikti reikalavimus? Taip. Digital Link gali atskleisti kelias tipizuotas nuorodas (linkset) – jūsų rinkodaros puslapį, oficialų pasą, perdirbimo duomenų lapą – kiekvieną pažymėtą nuorodos tipu.

Šaltiniai

Išbandykite gyvą pasą aukščiau, tada pradėkite nemokamai ir suraskite savo paties.