GS1 Digital Link резолверът, обяснен (с жив пример)

Повечето обяснения за QR кодовете на цифровия продуктов паспорт спират на „сканирай кода, отвори уебсайт". Това пропуска интересната част. QR кодът върху съответстващ продукт кодира GS1 Digital Link, а компонентът, който го прави полезен, е резолверът — услугата, която превръща един продуктов идентификатор в множество различни, контекстно зависими отговори.

Тази статия показва какво всъщност прави резолверът, заедно с жив паспорт, който можете да извикате точно сега (без регистрация, без ключ).

Какво всъщност е GS1 Digital Link

GS1 Digital Link е нормален HTTPS URL, който вгражда GS1 идентификатори като сегменти от пътя, всеки маркиран с Application Identifier (AI):

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

01 → GTIN (Global Trade Item Number) — кой продукт
21 → сериен номер — коя конкретна единица
10 → партида/серия (алтернатива на серийния номер)

Тъй като е обикновен URL, всяка телефонна камера го отваря. Тъй като е структуриран, машините могат да го анализират. Тази двойствена природа е цялата идея.

Резолверът: един URI, много отговори

Глупавият QR код връща една фиксирана страница. Резолверът инспектира заявката и връща представянето, което подхожда на извикващия:

потребител с телефонен браузър получава четима за хора HTML страница;
системата на рециклатор иска JSON-LD и получава машинночитаеми структурирани данни;
орган може да поиска пълния linkset — всяка типизирана връзка, която продуктът излага.

Същият URL, различни отговори, определени от хедъра Accept (или чрез заместване с ?format=).

Жив резолвер, който можете да извикате точно сега

qr3.app хоства публичен демонстрационен паспорт на батерия. Отворете го в браузър:

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

Ще видите потребителската страница на EcoMax 5000 (Demo) от GreenPower GmbH. Сега поискайте от същия URL машинночитаем 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)"
}

Това е резолверът, който върши работата си: един идентификатор, страница за хора и JSON-LD документ, изграден върху schema.org + уеб речника на GS1. Други представяния са достъпни по същия начин — ?format=json (суров паспорт), ?format=linkset (всички типизирани връзки), ?format=dcat-ap — или чрез стандартно договаряне с Accept (Accept: application/ld+json).

Валидирайте идентификаторите, преди да създадете връзки

Резолверът е толкова надежден, колкото идентификаторите зад него. Валидирайте GTIN, преди да изградите 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"

Регистрирайте своите GTIN

Поддържайте под управление идентификаторите, които използвате, така че всеки Digital Link да се проследява обратно до известен продукт:

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

Използване на qr3 като ваш резолвер

Не е необходимо сами да изграждате и управлявате резолвер. Насочете QR кода на продукта си към Digital Link, хоствайте паспорта в qr3.app и резолверът ще обслужва правилното представяне за всяка заявка. GTIN/серийният номер в URL остават стабилни завинаги (така че отпечатаните етикети никога не се развалят), докато данните зад тях остават обновяеми.

Често задавани въпроси

Различен ли е самият QR код от нормалния? Не — той е стандартен QR (или Data Matrix), носещ URL на GS1 Digital Link. Всяка камера го отваря; интелигентността е в резолвера, а не в символа.

Наистина ли потребителите и рециклаторите получават различно съдържание? Да — това е договаряне на съдържание. Браузърът получава HTML; система, искаща application/ld+json (или ?format=jsonld), получава структурирани данни от същия URL.

Мога ли да запазя собствената си продуктова страница и пак да съм съответстващ? Да. Digital Link може да излага множество типизирани връзки (linkset) — вашата маркетингова страница, официалния паспорт, лист с данни за рециклиране — всяка маркирана с тип на връзката.

Източници

Опитайте живия паспорт по-горе, след което започнете безплатно и резолвирайте своя собствен.