Skip to content
qr3.app Docs

GS1-selvitin

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}

DPP:tä luotaessa (POST /v1/dpp) sovelletaan seuraavia sääntöjä: 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:

AcceptVastaus
text/htmlKuluttaja-HTML
application/ld+jsonJSON-LD
application/jsonRaaka DPP-JSON
application/linkset+jsonLinkset 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 paikallista osumaa ei löydy, GS1-selvitin ohjaa pyynnön koodilla 307 osoitteeseen https://id.gs1.org. GTIN-aliaksessa /dpp/:gtin/:serial?lot=... tämä koskee myös virheellistä GTIN-tarkistusnumeroa: gtin, lot ja serial koodataan erikseen URL-polun osiksi, myös varatut erotinmerkit. Uudelleenohjaus ei vahvista GTIN:n oikeellisuutta eikä tietojen saatavuutta GS1:ssä.

Poikkeus: jos dekoodattu tunniste on pelkkä . tai .., alias ilman paikallista osumaa vastaa koodilla 422, muodossa application/problem+json, tyypillä https://docs.qr3.app/errors/validation ja ilmoittaa kyseisen kentän kohdassa errors[], ilman uudelleenohjausta. URL-jäsentimet normalisoivat nämä polun osat myös koodattuina. Arvot kuten LOT.1 ja ... voidaan edelleen välittää. Poikkeus koskee vain tätä aliasta ilman osumaa; luomisen validointi, kanoninen selvitin ja olemassa olevat osumat eivät muutu.

GET /dpp/{GTIN}/UNKNOWN?lot=LOT%2F1
307 Location: https://id.gs1.org/01/{GTIN}/10/LOT%2F1/21/UNKNOWN


GET /dpp/{GTIN}/UNKNOWN?lot=.
422 Content-Type: application/problem+json

Käytäntö

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