An GS1 Digital Link Resolver, Mínithe (le sampla beo)

Stadann formhór na mínithe faoi chóid QR an Phas Táirge Dhigitigh ag "scanáil an cód, oscail suíomh gréasáin." Cailltear an chuid spéisiúil ansin. Ionchódaíonn an cód QR ar tháirge comhlíontach GS1 Digital Link, agus is é an chomhpháirt a fhágann úsáideach é ná an resolver — an tseirbhís a iompaíonn aitheantóir táirge amháin ina iliomad freagraí éagsúla atá feasach ar chomhthéacs.

Léiríonn an t-alt seo a ndéanann an resolver i ndáiríre, le pas beo is féidir leat glao a chur air anois díreach (gan clárú, gan eochair).

Cad is GS1 Digital Link ann dáiríre

Is gnáth-URL HTTPS é GS1 Digital Link a leabaíonn aitheantóirí GS1 mar mhíreanna conaire, gach ceann clibeáilte le Application Identifier (AI):

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

01 → GTIN (Global Trade Item Number) — cén táirge
21 → sraithuimhir — cén t-aonad aonair
10 → baisc/lota (rogha eile in ionad sraithuimhreach)

Toisc gur gnáth-URL é, osclaíonn ceamara fóin ar bith é. Toisc go bhfuil sé struchtúrtha, is féidir le meaisíní é a pharsáil. Is é an déchineál sin an pointe ar fad.

An resolver: URI amháin, mórán freagraí

Tugann cód QR balbh leathanach socraithe amháin ar ais. Iniúchann resolver an t-iarratas agus tugann sé ar ais an léiriú a oireann don ghlaoiteoir:

faigheann tomhaltóir le brabhsálaí fóin leathanach HTML atá inléite ag daoine;
iarrann córas athchúrsálaí JSON-LD agus faigheann sé sonraí struchtúrtha atá inléite ag meaisíní;
is féidir le húdarás an linkset iomlán a iarraidh — gach nasc clóscríofa a nochtann an táirge.

An URL céanna, freagraí éagsúla, a chinntear leis an gceanntásc Accept (nó le sárú ?format=).

Resolver beo is féidir leat glao a chur air anois díreach

Óstálann qr3.app pas ceallraí poiblí mar léiriú. Oscail i mbrabhsálaí é:

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

Feicfidh tú an leathanach tomhaltóra do EcoMax 5000 (Demo) ó GreenPower GmbH. Anois iarr an URL céanna le haghaidh JSON-LD atá inléite ag meaisíní:

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

Sin é an resolver i mbun a chuid oibre: aitheantóir amháin, leathanach do dhaoine agus doiciméad JSON-LD tógtha ar schema.org + stór focal gréasáin GS1. Tá léirithe eile ar fáil ar an mbealach céanna — ?format=json (pas amh), ?format=linkset (gach nasc clóscríofa), ?format=dcat-ap — nó trí ghnáth-idirbheartaíocht Accept (Accept: application/ld+json).

Bailíochtaigh aitheantóirí sula gcruthaíonn tú naisc

Níl resolver chomh hiontaofa ach amháin a mhéid is atá na haitheantóirí taobh thiar de. Bailíochtaigh GTIN sula dtógann tú Digital Link dó:

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"

Cláraigh do chuid GTINanna

Coinnigh na haitheantóirí a úsáideann tú faoi bhainistíocht ionas go rianaíonn gach Digital Link ar ais chuig táirge aitheanta:

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

qr3 a úsáid mar do resolver

Ní gá duit resolver a thógáil agus a oibriú tú féin. Dírigh cód QR do tháirge ar an Digital Link, óstáil an pas ar qr3.app, agus freastalaíonn an resolver an léiriú ceart in aghaidh an iarratais. Fanann an GTIN/sraithuimhir san URL cobhsaí go deo (mar sin ní bhriseann lipéid chlóite riamh), agus fanann na sonraí taobh thiar díobh in-nuashonraithe.

Ceisteanna Coitianta

An bhfuil an cód QR féin difriúil ó ghnáthcheann? Níl — is gnáthchód QR (nó Data Matrix) é a iompraíonn URL GS1 Digital Link. Osclaíonn ceamara ar bith é; tá an éirim sa resolver, ní sa tsiombail.

An bhfaigheann tomhaltóirí agus athchúrsálaithe ábhar difriúil i ndáiríre? Faigheann — sin idirbheartaíocht ábhair. Faigheann an brabhsálaí HTML; faigheann córas a iarrann application/ld+json (nó ?format=jsonld) sonraí struchtúrtha ón URL céanna.

An féidir liom mo leathanach táirge féin a choinneáil agus a bheith comhlíontach fós? Is féidir. Is féidir leis an Digital Link iliomad naisc chlóscríofa a nochtadh (linkset) — do leathanach margaíochta, an pas oifigiúil, bileog sonraí athchúrsála — gach ceann clibeáilte le cineál naisc.

Foinsí

Bain triail as an bpas beo thuas, ansin tosaigh saor in aisce agus réitigh do cheann féin.