Skip to content
qr3.app Docs

Réititheoir GS1

Réititheoir GS1

Is é an Réititheoir GS1 an ciseal léite poiblí le haghaidh DPP. Is mar seo a leanas a bhreathnaíonn an URL canónta:

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}

Agus DPP á chruthú (POST /v1/dpp), tá na rialacha seo i bhfeidhm: Ní mór do serial agus lot deighleoga conaire slána GS1 a úsáid: ach A-Z, a-z, 0-9, ., _, ~, - amháin agus fad idir 1 agus 20 carachtar. Diúltófar do dheighilteoirí URL forchoimeádta chun a chinntiú go bhfanfaidh an nasc canónta inréitithe.

Caibidlíocht Inneachair

Soláthraíonn an réititheoir céanna léirithe difriúla ag brath ar an gceanntásc Accept:

AcceptFreagra
text/htmlHTML Tomhaltóra
application/ld+jsonJSON-LD
application/jsonJSON DPP Amh
application/linkset+jsonLinkset le roghanna eile

Bealaí atá infheicthe go poiblí

  • Is é GET /01/... an réititheoir canónta
  • Is ailias HTML é GET /dpp/:gtin/:serial?lot=...
  • Soláthraíonn GET /v1/dpp/:id/qr.svg an SVG
  • Soláthraíonn GET /v1/dpp/:id/qr.png an PNG
  • Soláthraíonn GET /v1/dpp/:id/qr.pdf an PDF
  • Soláthraíonn GET /v1/dpp/:id/qr.eps an EPS

Braitheann infheictheacht na sócmhainní QR ar stádas an DPP:

  • Tá live inrochtana go poiblí gan fíordheimhniú
  • Teastaíonn comhthéacs fíordheimhnithe bailí móide rochtain ar an Workspace do draft agus archived
  • Soláthraíonn fíordheimhniú neamhbhailí 401
  • Soláthraíonn Workspaces nach bhfuil infheicthe nó ar le tríú páirtí iad 404

Fallback

Mura bhfuil meaitseáil áitiúil ann, atreoraíonn an réititheoir GS1 le 307 chuig https://id.gs1.org. Maidir leis an ailias GTIN /dpp/:gtin/:serial?lot=..., tá sé seo i bhfeidhm fiú má tá digit seiceála an GTIN neamhbhailí: ionchódaítear gtin, lot agus serial ar leithligh mar dheighleoga conaire URL, deighilteoirí forchoimeádta san áireamh. Ní dhearbhaíonn an t-atreorú bailíocht an GTIN ná infhaighteacht sonraí ag GS1.

Eisceacht: mura bhfuil san aitheantóir díchódaithe ach . nó .., freagraíonn an t-ailias gan mheaitseáil áitiúil le 422, application/problem+json, an cineál https://docs.qr3.app/errors/validation agus an réimse lena mbaineann in errors[], gan atreorú. Déanann parsálaithe URL na deighleoga seo a normalú fiú i bhfoirm ionchódaithe. Is féidir luachanna amhail LOT.1 agus ... a chur ar aghaidh fós. Ní bhaineann an eisceacht ach leis an ailias seo gan mheaitseáil; ní athraítear bailíochtú cruthaithe, an réititheoir canónta ná meaitseálacha atá ann cheana.

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

Cleachtas

  1. Cruthaigh DPP sa deais.
  2. Úsáid an URI GS1 mar sprioc QR.
  3. Treoraigh córais tomhaltais chuig an bhformáid atá ag teastáil trí Accept.