Ir-Resolver tal-GS1 Digital Link, Spjegat (b'eżempju ħaj)

Ħafna spjegazzjonijiet dwar il-kodiċijiet QR tal-Passaport Diġitali tal-Prodott jieqfu fuq "skennja l-kodiċi, iftaħ websajt." Dak jitlef il-parti interessanti. Il-kodiċi QR fuq prodott konformi jikkodifika GS1 Digital Link, u l-komponent li jagħmlu utli huwa r-resolver — is-servizz li jibdel identifikatur wieħed ta' prodott f'ħafna tweġibiet differenti u sensittivi għall-kuntest.

Dan l-artiklu juri x'jagħmel verament ir-resolver, b'passaport ħaj li tista' ssejjaħ issa stess (l-ebda reġistrazzjoni, l-ebda ċavetta).

X'inhu verament GS1 Digital Link

GS1 Digital Link huwa URL HTTPS normali li jinkorpora identifikaturi GS1 bħala segmenti tal-path, kull wieħed ittikkjat b'Application Identifier (AI):

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

01 → GTIN (Global Trade Item Number) — liema prodott
21 → serial — liema unità individwali
10 → batch/lott (alternattiva għas-serial)

Peress li huwa URL sempliċi, kwalunkwe kamera tat-telefon tiftħu. Peress li huwa strutturat, il-magni jistgħu janalizzawh. Din in-natura doppja hija l-iskop kollu.

Ir-resolver: URI wieħed, ħafna tweġibiet

Kodiċi QR stupidu jirritorna paġna fissa waħda. Resolver jispezzjona t-talba u jirritorna r-rappreżentazzjoni li taqbel mas-sejjieħ:

konsumatur b'browser tat-telefon jikseb paġna HTML li tinqara mill-bniedem;
is-sistema ta' riċiklatur titlob JSON-LD u tikseb data strutturata li tinqara mill-magni;
awtorità tista' titlob il-linkset sħiħ — kull link tipizzat li l-prodott jesponi.

L-istess URL, tweġibiet differenti, deċiżi mill-header Accept (jew override ?format=).

Resolver ħaj li tista' ssejjaħ issa stess

qr3.app jospita passaport ta' batterija demo pubbliku. Iftħu f'browser:

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

Tara l-paġna tal-konsumatur għal EcoMax 5000 (Demo) minn GreenPower GmbH. Issa staqsi lill-istess URL għal JSON-LD li tinqara mill-magni:

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

Dak huwa r-resolver jagħmel xogħlu: identifikatur wieħed, paġna għall-bniedem u dokument JSON-LD mibni fuq schema.org + il-vokabularju web tal-GS1. Rappreżentazzjonijiet oħra huma disponibbli bl-istess mod — ?format=json (passaport mhux ipproċessat), ?format=linkset (kull link tipizzat), ?format=dcat-ap — jew permezz tan-negozjar standard Accept (Accept: application/ld+json).

Ivvalida l-identifikaturi qabel ma toħloq il-links

Resolver huwa biss daqshekk affidabbli daqs l-identifikaturi ta' warajh. Ivvalida GTIN qabel ma tibni Digital Link għalih:

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"

Irreġistra l-GTINs tiegħek

Żomm l-identifikaturi li tuża taħt ġestjoni biex kull Digital Link jintraċċa lura għal prodott magħruf:

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

L-użu ta' qr3 bħala r-resolver tiegħek

M'għandekx għalfejn tibni u tħaddem resolver int innifsek. Indirizza l-kodiċi QR tal-prodott tiegħek lejn id-Digital Link, ospita l-passaport fuq qr3.app, u r-resolver iservi r-rappreżentazzjoni t-tajba għal kull talba. Il-GTIN/serial fl-URL jibqgħu stabbli għal dejjem (biex it-tikketti stampati qatt ma jinqasmu), filwaqt li d-data ta' warajhom tibqa' aġġornabbli.

FAQ

Il-kodiċi QR innifsu huwa differenti minn wieħed normali? Le — huwa QR standard (jew Data Matrix) li jġorr URL ta' GS1 Digital Link. Kwalunkwe kamera tiftħu; l-intelliġenza tinsab fir-resolver, mhux fis-simbolu.

Il-konsumaturi u r-riċiklaturi verament jiksbu kontenut differenti? Iva — dak huwa negozjar tal-kontenut. Il-browser jikseb HTML; sistema li titlob application/ld+json (jew ?format=jsonld) tikseb data strutturata mill-istess URL.

Nista' nżomm il-paġna tal-prodott tiegħi stess u xorta nkun konformi? Iva. Id-Digital Link jista' jesponi diversi links tipizzati (linkset) — il-paġna tal-marketing tiegħek, il-passaport uffiċjali, datasheet tar-riċiklaġġ — kull wieħed ittikkjat b'tip ta' link.

Sorsi

Ipprova l-passaport ħaj hawn fuq, imbagħad ibda b'xejn u rrisolvi tiegħek stess.