Lielākā daļa skaidrojumu par digitālās produkta pases QR kodiem apstājas pie "noskenē kodu, atver vietni". Tas palaiž garām interesantāko daļu. QR kods uz atbilstoša produkta kodē GS1 Digital Link, un komponents, kas to padara noderīgu, ir risinātājs — pakalpojums, kas pārvērš vienu produkta identifikatoru daudzās dažādās, konteksta atkarīgās atbildēs.
Šis raksts parāda, ko risinātājs patiesībā dara, ar dzīvu pasi, ko vari izsaukt tieši tagad (bez reģistrācijas, bez atslēgas).
Kas patiesībā ir GS1 Digital Link
GS1 Digital Link ir parasts HTTPS URL, kas iegulst GS1 identifikatorus kā ceļa segmentus, katru atzīmējot ar lietojumprogrammas identifikatoru (Application Identifier, AI):
https://id.gs1.org/01/04019999999902/21/DEMO-BAT-01
└─01─┘ └──GTIN───┘ └21┘ └─serial─┘
01→ GTIN (Global Trade Item Number) — kurš produkts21→ sērijas numurs — kura konkrētā vienība10→ partija/sērija (alternatīva sērijas numuram)
Tā kā tas ir vienkāršs URL, jebkura tālruņa kamera to atver. Tā kā tas ir strukturēts, mašīnas to var parsēt. Šī divējādā daba ir visa būtība.
Risinātājs: viens URI, daudzas atbildes
Vienkāršs QR kods atgriež vienu fiksētu lapu. Risinātājs pārbauda pieprasījumu un atgriež reprezentāciju, kas atbilst izsaucējam:
- patērētājs ar tālruņa pārlūku saņem cilvēkam lasāmu HTML lapu;
- pārstrādātāja sistēma pieprasa JSON-LD un saņem mašīnlasāmus strukturētus datus;
- iestāde var pieprasīt pilno linkset — katru tipizēto saiti, ko produkts atklāj.
Tas pats URL, dažādas atbildes, ko izšķir Accept galvene (vai ?format= aizstāšana).
Dzīvs risinātājs, ko vari izsaukt tieši tagad
qr3.app uztur publisku demonstrācijas akumulatora pasi. Atver to pārlūkā:
Tu redzēsi patērētāja lapu produktam EcoMax 5000 (Demo) no GreenPower GmbH. Tagad pieprasi to pašu URL mašīnlasāmā JSON-LD formā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ā risinātājs dara savu darbu: viens identifikators, cilvēkam lasāma lapa un JSON-LD dokuments, kas balstīts uz schema.org + GS1 tīmekļa vārdnīcu. Citas reprezentācijas ir pieejamas tādā pašā veidā — ?format=json (neapstrādāta pase), ?format=linkset (visas tipizētās saites), ?format=dcat-ap — vai izmantojot standarta Accept saskaņošanu (Accept: application/ld+json).
Validē identifikatorus pirms saišu izveides
Risinātājs ir uzticams tikai tik, cik uzticami ir identifikatori aiz tā. Validē GTIN pirms veido tam 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"
Reģistrē savus GTIN
Uzturi izmantotos identifikatorus pārvaldībā, lai katrs Digital Link būtu izsekojams līdz zināmam produktam:
const gtin = await client.gs1.createGs1Identifier({
identifier_type: "gtin", // or "gln" | "company_prefix"
value: "04019999999902",
label: "EcoMax 5000",
});
qr3 izmantošana kā risinātāju
Tev nav pašam jāveido un jāuztur risinātājs. Norādi sava produkta QR kodu uz Digital Link, mitini pasi qr3.app, un risinātājs katram pieprasījumam pasniegs pareizo reprezentāciju. GTIN/sērijas numurs URL paliek mūžīgi stabili (tāpēc drukātās etiķetes nekad nesalūzt), kamēr dati aiz tiem paliek atjaunināmi.
FAQ
Vai pats QR kods atšķiras no parasta? Nē — tas ir standarta QR kods (vai Data Matrix), kas nes GS1 Digital Link URL. Jebkura kamera to atver; inteliģence ir risinātājā, nevis simbolā.
Vai patērētāji un pārstrādātāji tiešām saņem dažādu saturu?
Jā — tā ir satura saskaņošana. Pārlūks saņem HTML; sistēma, kas pieprasa application/ld+json (vai ?format=jsonld), saņem strukturētus datus no tā paša URL.
Vai es varu saglabāt savu produkta lapu un joprojām būt atbilstošs?
Jā. Digital Link var atklāt vairākas tipizētas saites (linkset) — tavu mārketinga lapu, oficiālo pasi, pārstrādes datu lapu — katru atzīmētu ar saites tipu.
Avoti
Izmēģini dzīvo pasi augstāk, tad sāc bez maksas un risini savu produktu.