GS1-selvitin

GS1-selvitin on DPP:n julkinen lukukerros. Kanoninen URL-osoite näyttää tältä:

https://qr3.app/01/{GTIN}
https://qr3.app/01/{GTIN}/10/{LOT}
https://qr3.app/01/{GTIN}/21/{SERIAL}
https://qr3.app/01/{GTIN}/10/{LOT}/21/{SERIAL}

serial ja lot täytyy käyttää turvallisia GS1-polun osia: vain A-Z, a-z, 0-9, ., _, ~, - ja pituus 1–20 merkkiä. Varatut URL-erotinmerkit hylätään, jotta kanoninen linkki pysyy selvitettävissä.

Content Negotiation

Sama selvitin palauttaa eri esitysmuotoja Accept-otsikon perusteella:

Accept	Vastaus
`text/html`	Kuluttaja-HTML
`application/ld+json`	JSON-LD
`application/json`	Raaka DPP-JSON
`application/linkset+json`	Linkset vaihtoehdoilla

Julkisesti näkyvät reitit

GET /01/... on kanoninen selvitin
GET /dpp/:gtin/:serial?lot=... on HTML-alias
GET /v1/dpp/:id/qr.svg palauttaa SVG-tiedoston
GET /v1/dpp/:id/qr.png palauttaa PNG-tiedoston
GET /v1/dpp/:id/qr.pdf palauttaa PDF-tiedoston
GET /v1/dpp/:id/qr.eps palauttaa EPS-tiedoston

QR-resurssien näkyvyys määräytyy DPP-tilan mukaan:

live on julkisesti saatavilla ilman todennusta
draft ja archived vaativat voimassa olevan tunnistautumiskontekstin sekä Workspace-pääsyn
Virheellinen todennus palauttaa tilakoodin 401
Näkymättömät tai muiden organisaatioiden Workspacet palauttavat tilakoodin 404

Fallback

Jos qr3.app ei löydä osumaa, pyyntö ohjataan eteenpäin ylemmälle GS1-selvittimelle. Tämä on tärkeää, jotta tulostetut koodit toimivat silloinkin, kun tuotetta ei ole vielä rekisteröity paikallisesti.

Käytäntö

Luo DPP hallintapaneelissa (Dashboard).
Käytä GS1-URI-osoitetta QR-koodin kohteena.
Ohjaa kuluttavat järjestelmät haluttuun muotoon Accept-otsikon avulla.