--- title: "GS1 Digital Link -resolveri selitettynä (mukana toimiva esimerkki) — qr3.app Blog" description: "DPP-QR-koodi ei ole linkki verkkosivulle — se on GS1 Digital Link, ja resolveri muuntaa yhden tunnisteen useiksi kontekstitietoisiksi vastauksiksi. Näin se toimii, mukana elossa oleva passi, jota voit kutsua curlilla juuri nyt." canonical: "https://qr3.app/fi/blog/gs1-digital-link-resolver/" lang: "fi" robots: "index,follow,max-image-preview:large,max-snippet:-1" --- # GS1 Digital Link -resolveri selitettynä (mukana toimiva esimerkki) — qr3.app Blog > DPP-QR-koodi ei ole linkki verkkosivulle — se on GS1 Digital Link, ja resolveri muuntaa yhden tunnisteen useiksi kontekstitietoisiksi vastauksiksi. Näin se toimii, mukana elossa oleva passi, jota voit kutsua curlilla juuri nyt. Canonical: [← Blogi](/fi/blog/) [Tutoriaalit](/fi/blog/category/tutorials/) 30. toukokuuta 2026 3 min lukuaika [Tutoriaalit](/fi/blog/category/tutorials/) [gs1-digital-link](/fi/blog/tag/gs1-digital-link/)[resolver](/fi/blog/tag/resolver/)[dpp](/fi/blog/tag/dpp/)[gtin](/fi/blog/tag/gtin/)[json-ld](/fi/blog/tag/json-ld/) # GS1 Digital Link -resolveri selitettynä (mukana toimiva esimerkki) DPP-QR-koodi ei ole linkki verkkosivulle — se on GS1 Digital Link, ja resolveri muuntaa yhden tunnisteen useiksi kontekstitietoisiksi vastauksiksi. Näin se toimii, mukana elossa oleva passi, jota voit kutsua curlilla juuri nyt. kirjoittanut **QR3 Redaktion** ![GS1 Digital Link -resolveri selitettynä (mukana toimiva esimerkki)](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/gs1-digital-link-resolver/hero.png) Useimmat digitaalisten tuotepassien QR-koodeja käsittelevät selitykset pysähtyvät kohtaan "skannaa koodi, avaa verkkosivu". Siitä jää uupumaan kaikkein kiinnostavin osa. Vaatimustenmukaisen tuotteen QR-koodi sisältää **GS1 Digital Link** -tunnisteen, ja komponentti, joka tekee siitä hyödyllisen, on **resolveri** — palvelu, joka muuntaa yhden tuotetunnisteen useiksi erilaisiksi, kontekstitietoisiksi vastauksiksi. Tässä artikkelissa näytetään, mitä resolveri todella tekee, ja mukana on **elossa oleva passi, jota voit kutsua juuri nyt** (ei rekisteröitymistä, ei avainta). ## Mitä GS1 Digital Link oikeastaan on GS1 Digital Link on tavallinen HTTPS-URL, joka upottaa GS1-tunnisteet polkusegmenteiksi, joista kukin on merkitty **sovellustunnisteella (Application Identifier, AI)**: ``` https://id.gs1.org/01/09520000000011/21/DEMO-BAT-01 └─01─┘ └──GTIN───┘ └21┘ └─serial─┘ ``` - `01` → GTIN (Global Trade Item Number) — *mikä tuote* - `21` → sarjanumero — *mikä yksittäinen kappale* - `10` → erä/eränumero (vaihtoehto sarjanumerolle) Koska se on tavallinen URL, mikä tahansa puhelimen kamera avaa sen. Koska se on *jäsennelty*, koneet voivat jäsentää sen. Juuri tämä kaksoisluonne on koko pointti. ## Resolveri: yksi URI, monta vastausta Tyhmä QR-koodi palauttaa yhden kiinteän sivun. **Resolveri** tarkastaa pyynnön ja palauttaa esitysmuodon, joka sopii kutsujalle: - **kuluttaja**, jolla on puhelimen selain, saa ihmisluettavan HTML-sivun; - **kierrättäjän** järjestelmä pyytää JSON-LD:tä ja saa koneluettavaa jäsenneltyä dataa; - **viranomainen** voi pyytää koko *linksetin* — jokaisen tyypitetyn linkin, jonka tuote tarjoaa. Sama URL, eri vastaukset, jotka määräytyvät `Accept`-otsakkeen (tai `?format=`-ohituksen) perusteella. ## Elossa oleva resolveri, jota voit kutsua juuri nyt qr3.app isännöi julkista demo-akkupassia. Avaa se selaimessa: > **[https://qr3.app/dpp/09520000000011/DEMO-BAT-01](https://qr3.app/dpp/09520000000011/DEMO-BAT-01)** Näet kuluttajasivun tuotteelle *EcoMax 5000 (Demo)*, valmistajana GreenPower GmbH. Pyydä nyt **samalta URL-osoitteelta** koneluettavaa JSON-LD:tä: ``` curl "https://qr3.app/dpp/09520000000011/DEMO-BAT-01?format=jsonld" ``` ``` { "@context": ["https://schema.org", "https://gs1.org/voc/"], "@type": "Product", "gtin": "09520000000011", "name": "EcoMax 5000 (Demo)" } ``` Tässä resolveri tekee työtään: yksi tunniste, ihmisluettava sivu **ja** JSON-LD-dokumentti, joka rakentuu `schema.org`-sanaston ja GS1:n verkkosanaston päälle. Muut esitysmuodot ovat saatavilla samalla tavalla — `?format=json` (raaka passi), `?format=linkset` (kaikki tyypitetyt linkit), `?format=dcat-ap` — tai tavallisen `Accept`-neuvottelun kautta (`Accept: application/ld+json`). ## Validoi tunnisteet ennen kuin luot linkkejä Resolveri on vain niin luotettava kuin sen taustalla olevat tunnisteet. Validoi GTIN ennen kuin rakennat sille Digital Linkin: ``` 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: "09520000000011", }); console.log(result.valid); // true console.log(result.detail); // "Valid GTIN-14" ``` ## Rekisteröi GTIN-tunnisteesi Pidä käyttämäsi tunnisteet hallinnassa, jotta jokainen Digital Link johtaa takaisin tunnettuun tuotteeseen: ``` const gtin = await client.gs1.createGs1Identifier({ identifier_type: "gtin", // or "gln" | "company_prefix" value: "09520000000011", label: "EcoMax 5000", }); ``` ## qr3:n käyttäminen resolverina Sinun ei tarvitse rakentaa ja ylläpitää resolveria itse. Osoita tuotteesi QR-koodi Digital Linkiin, isännöi passi qr3.app-palvelussa, niin resolveri tarjoaa oikean esitysmuodon kutakin pyyntöä kohden. URL-osoitteen GTIN/sarjanumero pysyvät **pysyvästi muuttumattomina** (joten painetut etiketit eivät koskaan mene rikki), kun taas niiden takana oleva data pysyy päivitettävissä. ## UKK **Onko itse QR-koodi erilainen kuin tavallinen?** Ei — se on tavallinen QR (tai Data Matrix), joka kantaa GS1 Digital Link -URL-osoitetta. Mikä tahansa kamera avaa sen; älykkyys on resolverissa, ei symbolissa. **Saavatko kuluttajat ja kierrättäjät todella eri sisältöä?** Kyllä — se on sisältöneuvottelua. Selain saa HTML:ää; järjestelmä, joka pyytää `application/ld+json`-muotoa (tai `?format=jsonld`), saa jäsenneltyä dataa samalta URL-osoitteelta. **Voinko pitää oman tuotesivuni ja olla silti vaatimustenmukainen?** Kyllä. Digital Link voi tarjota useita tyypitettyjä linkkejä (`linkset`) — markkinointisivusi, virallisen passin, kierrätystietolomakkeen — joista kukin on merkitty linkin tyypillä. ## Lähteet - [GS1 Digital Link -standardi](https://www.gs1.org/standards/gs1-digital-link) - [GS1 Digital Link: Resolver](https://www.gs1.org/standards/resolver) - [ESPR — asetus (EU) 2024/1781](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32024R1781) **Kokeile elossa olevaa passia** yllä, ja [aloita ilmaiseksi](https://app.qr3.app/sign-up) ja resolvoi omasi. Nämä ovat toimivia demoja, joissa käytetään kuvitteellisia tuotetietoja ja GS1-etuliitteen 952 esimerkki-GTIN-koodeja. Ne eivät osoita myönnettyjä tuotetunnuksia, rekisterimerkintää tai sertifiointia. ## Aiheeseen liittyvät artikkelit - [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/dpp-json-ld-epcis/hero.png) Tutoriaalit JSON-LD digitaalisille tuotepasseille (ja mihin EPCIS 2.0 sopii) DPP on hyödyllinen koneille vain, jos se on koneluettava. Tämä opas näyttää todellisen JSON-LD:n, jonka qr3-passi tarjoaa live-resolverin kautta, kuinka yksi URL palvelee sekä ihmisiä että koneita sisältöneuvottelun avulla ja mihin täydentävä EPCIS 2.0 -tapahtumastandardi sopii.](/fi/blog/dpp-json-ld-epcis/) - [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/gs1-resolver-test-suite-dpp-links/hero.png) Tutoriaalit GS1 Resolver Test Suite: DPP-linkkien luotettava tarkistus ennen käyttöönottoa Vakaa GS1-testisarja mahdollistaa Resolver 1.2:n tarkistamisen. Näin testaat uudelleenohjaukset, linkkijoukot, CORSin, kielet ja virhetilanteet ennen käyttöönottoa.](/fi/blog/gs1-resolver-test-suite-dpp-links/) - [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/dpp-battery-passport-2027-20260715/hero.png) Toimialauutiset BatteryPass-Ready käynnisti digitaalisen akkupassin testiympäristön BatteryPass-Ready-konsortio käynnisti 24. kesäkuuta 2026 julkisen digitaalisen akkupassin testiympäristön EU-velvoitteen lähestyessä helmikuussa 2027.](/fi/blog/dpp-battery-passport-2027-20260715/) - [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/sector-20260713/hero.png) Toimialauutiset Digitaalinen akkupassi 2027: mitä valmistajien on nyt tiedettävä Webinaarit, avoimen lähdekoodin työkalut ja uudet standardit: EU:n akkupassi etenee. Katsaus heinäkuun 2026 tilanteeseen ja avoimiin kysymyksiin helmikuuhun 2027 asti.](/fi/blog/sector-20260713/) [← Kaikki artikkelit](/fi/blog/) [Aloita ilmaiseksi](https://app.qr3.app/sign-up)