GS1 Digital Link -resolveri selitettynä (mukana toimiva esimerkki)

Useimmat digitaalisten tuotepassien QR-koodeja käsittelevät selitykset pysähtyvät kohtaan "skannaa koodi, avaa verkkosivu". Siitä jää uupumaan kaikkein kiinnostavin osa. Vaatimustenmukaisen tuotteen QR-koodi sisältää GS1 Digital Link -tunnisteen, ja komponentti, joka tekee siitä hyödyllisen, on resolveri — palvelu, joka muuntaa yhden tuotetunnisteen useiksi erilaisiksi, kontekstitietoisiksi vastauksiksi.

Tässä artikkelissa näytetään, mitä resolveri todella tekee, ja mukana on elossa oleva passi, jota voit kutsua juuri nyt (ei rekisteröitymistä, ei avainta).

Mitä GS1 Digital Link oikeastaan on

GS1 Digital Link on tavallinen HTTPS-URL, joka upottaa GS1-tunnisteet polkusegmenteiksi, joista kukin on merkitty sovellustunnisteella (Application Identifier, AI):

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

01 → GTIN (Global Trade Item Number) — mikä tuote
21 → sarjanumero — mikä yksittäinen kappale
10 → erä/eränumero (vaihtoehto sarjanumerolle)

Koska se on tavallinen URL, mikä tahansa puhelimen kamera avaa sen. Koska se on jäsennelty, koneet voivat jäsentää sen. Juuri tämä kaksoisluonne on koko pointti.

Resolveri: yksi URI, monta vastausta

Tyhmä QR-koodi palauttaa yhden kiinteän sivun. Resolveri tarkastaa pyynnön ja palauttaa esitysmuodon, joka sopii kutsujalle:

kuluttaja, jolla on puhelimen selain, saa ihmisluettavan HTML-sivun;
kierrättäjän järjestelmä pyytää JSON-LD:tä ja saa koneluettavaa jäsenneltyä dataa;
viranomainen voi pyytää koko linksetin — jokaisen tyypitetyn linkin, jonka tuote tarjoaa.

Sama URL, eri vastaukset, jotka määräytyvät Accept-otsakkeen (tai ?format=-ohituksen) perusteella.

Elossa oleva resolveri, jota voit kutsua juuri nyt

qr3.app isännöi julkista demo-akkupassia. Avaa se selaimessa:

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

Näet kuluttajasivun tuotteelle EcoMax 5000 (Demo), valmistajana GreenPower GmbH. Pyydä nyt samalta URL-osoitteelta koneluettavaa JSON-LD:tä:

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

Tässä resolveri tekee työtään: yksi tunniste, ihmisluettava sivu ja JSON-LD-dokumentti, joka rakentuu schema.org-sanaston ja GS1:n verkkosanaston päälle. Muut esitysmuodot ovat saatavilla samalla tavalla — ?format=json (raaka passi), ?format=linkset (kaikki tyypitetyt linkit), ?format=dcat-ap — tai tavallisen Accept-neuvottelun kautta (Accept: application/ld+json).

Validoi tunnisteet ennen kuin luot linkkejä

Resolveri on vain niin luotettava kuin sen taustalla olevat tunnisteet. Validoi GTIN ennen kuin rakennat sille Digital Linkin:

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"

Rekisteröi GTIN-tunnisteesi

Pidä käyttämäsi tunnisteet hallinnassa, jotta jokainen Digital Link johtaa takaisin tunnettuun tuotteeseen:

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

qr3:n käyttäminen resolverina

Sinun ei tarvitse rakentaa ja ylläpitää resolveria itse. Osoita tuotteesi QR-koodi Digital Linkiin, isännöi passi qr3.app-palvelussa, niin resolveri tarjoaa oikean esitysmuodon kutakin pyyntöä kohden. URL-osoitteen GTIN/sarjanumero pysyvät pysyvästi muuttumattomina (joten painetut etiketit eivät koskaan mene rikki), kun taas niiden takana oleva data pysyy päivitettävissä.

UKK

Onko itse QR-koodi erilainen kuin tavallinen? Ei — se on tavallinen QR (tai Data Matrix), joka kantaa GS1 Digital Link -URL-osoitetta. Mikä tahansa kamera avaa sen; älykkyys on resolverissa, ei symbolissa.

Saavatko kuluttajat ja kierrättäjät todella eri sisältöä? Kyllä — se on sisältöneuvottelua. Selain saa HTML:ää; järjestelmä, joka pyytää application/ld+json-muotoa (tai ?format=jsonld), saa jäsenneltyä dataa samalta URL-osoitteelta.

Voinko pitää oman tuotesivuni ja olla silti vaatimustenmukainen? Kyllä. Digital Link voi tarjota useita tyypitettyjä linkkejä (linkset) — markkinointisivusi, virallisen passin, kierrätystietolomakkeen — joista kukin on merkitty linkin tyypillä.

Lähteet

Kokeile elossa olevaa passia yllä, ja aloita ilmaiseksi ja resolvoi omasi.