Skip to content
qr3.app Docs

GS1 Resolver

GS1 Resolver

GS1 Resolver yra viešasis DPP skaitymo sluoksnis. Kanoninis URL atrodo taip:

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}

Kuriant DPP (POST /v1/dpp), taikomos šios taisyklės: serial ir lot privalo naudoti saugius GS1 kelio segmentus: tik A-Z, a-z, 0-9, ., _, ~, - ir ilgis nuo 1 iki 20 simbolių. Rezervuoti URL skirtukai yra atmetami, kad kanoninė nuoroda išliktų atpažįstama.

Turinio derybos (Content Negotiation)

Tas pats atpažintuvas, priklausomai nuo Accept antraštės, pateikia skirtingas reprezentacijas:

AcceptAtsakymas
text/htmlVartotojo HTML
application/ld+jsonJSON-LD
application/jsonGrynasis DPP JSON
application/linkset+jsonNuorodų rinkinys (Linkset) su alternatyvomis

Viešai matomi maršrutai

  • GET /01/... yra kanoninis atpažintuvas
  • GET /dpp/:gtin/:serial?lot=... yra HTML pseudonimas (alias)
  • GET /v1/dpp/:id/qr.svg pateikia SVG
  • GET /v1/dpp/:id/qr.png pateikia PNG
  • GET /v1/dpp/:id/qr.pdf pateikia PDF
  • GET /v1/dpp/:id/qr.eps pateikia EPS

QR išteklių matomumas priklauso nuo DPP būsenos:

  • live yra viešai pasiekiamas be autentifikavimo
  • draft ir archived reikalauja galiojančio autentifikavimo konteksto ir prieigos prie Workspace
  • Neteisingas autentifikavimas grąžina 401
  • Nematomi arba svetimi Workspaces grąžina 404

Atsarginis veikimas (Fallback)

Jei nėra vietinio atitikmens, GS1 sprendiklis peradresuoja su 307 į https://id.gs1.org. GTIN alternatyviam keliui /dpp/:gtin/:serial?lot=... tai taikoma ir esant neteisingam GTIN kontroliniam skaitmeniui: gtin, lot ir serial atskirai koduojami kaip URL kelio segmentai, įskaitant rezervuotus skirtukus. Peradresavimas nepatvirtina GTIN galiojimo ar duomenų prieinamumo GS1.

Išimtis: jei dekoduotas identifikatorius yra tik . arba .., alternatyvus kelias be vietinio atitikmens grąžina 422, application/problem+json, tipą https://docs.qr3.app/errors/validation ir paveiktą lauką sąraše errors[], be peradresavimo. URL analizatoriai normalizuoja šiuos segmentus net ir užkoduotus. Reikšmes, pavyzdžiui, LOT.1 ir ..., vis dar galima perduoti. Išimtis taikoma tik šiam keliui be atitikmens; kūrimo validavimas, kanoninis sprendiklis ir esami atitikmenys nesikeičia.

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

Praktika

  1. Sukurkite DPP valdymo skydelyje (Dashboard).
  2. Naudokite GS1 URI kaip QR tikslą.
  3. Nukreipkite vartojančias sistemas į pageidaujamą formatą per Accept antraštę.