GS1 Digital Link Resolver, förklarad (med ett live-exempel)

De flesta förklaringar om QR-koder för digitala produktpass stannar vid "skanna koden, öppna en webbsida." Det missar den intressanta delen. QR-koden på en regelefterlevande produkt kodar en GS1 Digital Link, och komponenten som gör den användbar är resolvern — tjänsten som förvandlar en produktidentifierare till många olika, kontextmedvetna svar.

Den här artikeln visar vad resolvern faktiskt gör, med ett live-pass du kan anropa just nu (ingen registrering, ingen nyckel).

Vad en GS1 Digital Link egentligen är

En GS1 Digital Link är en vanlig HTTPS-URL som bäddar in GS1-identifierare som sökvägssegment, var och en märkt med en Application Identifier (AI):

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

01 → GTIN (Global Trade Item Number) — vilken produkt
21 → serienummer — vilken enskild enhet
10 → batch/lot (alternativ till serienummer)

Eftersom det är en vanlig URL öppnar vilken telefonkamera som helst den. Eftersom den är strukturerad kan maskiner tolka den. Den dubbla naturen är hela poängen.

Resolvern: en URI, många svar

En enkel QR-kod returnerar en fast sida. En resolver inspekterar förfrågan och returnerar den representation som passar anroparen:

en konsument med en telefonläsare får en läsbar HTML-sida;
ett återvinningsföretags system begär JSON-LD och får maskinläsbar strukturerad data;
en myndighet kan begära hela linkset — varje typad länk som produkten exponerar.

Samma URL, olika svar, avgjort av Accept-headern (eller en ?format=-överstyrning).

En live-resolver du kan anropa just nu

qr3.app driftar ett offentligt demobatteripass. Öppna det i en webbläsare:

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

Du ser konsumentsidan för EcoMax 5000 (Demo) av GreenPower GmbH. Be nu samma URL om maskinläsbar 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)"
}

Det är resolvern som gör sitt jobb: en identifierare, en mänsklig sida och ett JSON-LD-dokument byggt på schema.org + GS1:s webbvokabulär. Andra representationer är tillgängliga på samma sätt — ?format=json (rått pass), ?format=linkset (alla typade länkar), ?format=dcat-ap — eller via standard Accept-förhandling (Accept: application/ld+json).

Validera identifierare innan du skapar länkar

En resolver är bara så pålitlig som identifierarna bakom den. Validera ett GTIN innan du bygger en Digital Link för det:

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"

Registrera dina GTIN:er

Håll de identifierare du använder under förvaltning så att varje Digital Link kan spåras tillbaka till en känd produkt:

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

Använda qr3 som din resolver

Du behöver inte bygga och driva en resolver själv. Peka din produkt-QR-kod mot Digital Link, hosta passet på qr3.app, så serverar resolvern rätt representation per förfrågan. GTIN/serienummer i URL:en förblir stabila för alltid (så att tryckta etiketter aldrig går sönder), medan datan bakom dem förblir uppdaterbar.

FAQ

Är själva QR-koden annorlunda än en vanlig? Nej — det är en standard-QR (eller Data Matrix) som bär en GS1 Digital Link-URL. Vilken kamera som helst öppnar den; intelligensen finns i resolvern, inte i symbolen.

Får konsumenter och återvinnare verkligen olika innehåll? Ja — det är innehållsförhandling. Webbläsaren får HTML; ett system som begär application/ld+json (eller ?format=jsonld) får strukturerad data från samma URL.

Kan jag behålla min egen produktsida och ändå vara regelefterlevande? Ja. Digital Link kan exponera flera typade länkar (ett linkset) — din marknadsföringssida, det officiella passet, ett återvinningsdatablad — var och en märkt med en länktyp.

Källor

Prova live-passet ovan, börja sedan gratis och resolva ditt eget.