Skip to content
qr3.app Docs

Log Athruithe

Log Athruithe

Buaicphointí coimeádta ó na heisiúintí is déanaí. Le haghaidh leaganacha iomlána API agus an pholasaí um athruithe briste, féach ar an Leaganú API & Polasaí LTS.

Mionathruithe ar phointí deiridh aonair: Sonraíocht OpenAPI agus Tagairt API idirghníomhach.

2026-10 · Dathanna sa Deais

  • Nua: tá an cárta Dathanna ar leathanach mionsonraí cóid: tulra agus cúlra mar luach heics, cúlra trédhearcach, réamhamharc tríd an bhfíorbhealach íomhá. Is í an tseiceáil chéanna í a dhéanann PATCH /v1/codes/{id}: teastaíonn deimhniú ó phéirí criticiúla, agus ní féidir péirí faoi 1.5:1 a shábháil.
  • Athshocrú go dubh ar bhán: tugann na ceithre fhormáid na bearta céanna arís agus a thugtar gan dathanna. Ní athraíonn cóid gan dathanna.
  • Cóid thrédhearcacha: taispeántar iad ar chlár ficheall i ngach réamhamharc sa Deais. Sonraí: Dathanna sa Deais.

2026-10 · Dathanna i PDF agus EPS

  • Nua: Tarraingíonn qr.pdf agus qr.eps fg agus bg, mar pharaiméadair agus mar dhathanna sábháilte. Scríobhtar dubh agus gach liath mar liathscála (pláta dubh amháin), agus gach dath eile mar CMYK i gcéatadáin iomlána, mar shampla 1F4E79 mar C74 M36 Y0 K53.
  • Cúlra cosúil leis an SVG: Chomh luath agus a roghnaítear dath, bíonn limistéar teimhneach taobh thiar den chód agus dá chrios ciúnais, bán nó bg. Ní tharraingíonn bg=transparent ceann ar bith. Fanann an teideal dubh, agus pláta an lógó bán.
  • Gan aon athrú gan dathanna: Gan fg/bg agus gan dathanna sábháilte, soláthraíonn an dá fhormáid na bearta céanna is a bhí roimhe seo. Fanann PDF pas táirge gan dath.
  • Teorainneacha: gan aon phróifíl ICC, gan aon PDF/X. Sonraí: Dathanna sa chló.

2026-09 · Cóid statacha gan taisce atreoraithe, scriosadh comhthráthach

  • Athraithe: Níl cóid statacha sa taisce atreoraithe a thuilleadh. Léann glaoch ar a nasc gairid (redirect_url) an staid reatha i gcónaí. Tar éis DELETE /v1/account, ní atreoraíonn cód statach a thuilleadh ag an gcéad ghlaoch eile dá bhrí sin, rud a d’fhéadfadh suas le 24 uair an chloig a thógáil roimhe seo. Bíonn éifeacht láithreach ag athrú taraife ar chóid statacha freisin. Glanann scriosadh an chuntais cóid dhinimiciúla mar is gnáth. Tá a gceann scríbe go díreach i gcóid statacha chlóite agus ní dhéantar difear dóibh.
  • Réitithe: Soláthraíonn dhá iarratas DELETE /v1/codes/:id chomhthráthacha ar an gcód céanna 200 uair amháin agus 404 uair amháin. Seoltar an webhook qr.deleted go díreach uair amháin, in ionad dhá uair roimhe seo.
  • Nua: Freagraíonn POST agus DELETE /v1/codes/:id/logo le 409 (errors/conflict) má d’athraigh iarratas eile lógó an chóid chéanna ag an am céanna, agus ní dhéanann siad aon athrú ansin. Roimhe seo, d’fhéadfadh lógó uaslódáilte fanacht sábháilte gan a bheith in úsáid. Soláthraíonn dhá iarratas DELETE /v1/codes/:id/logo chomhthráthacha 200 sa dá chás. Sonraí: Lógó.

2026-09 · TypeScript-SDK 1.2.0

  • Nua in @qr3/sdk 1.2.0: Glacann client.codes.update() le appearance agus soláthraíonn sé torthaí na seiceála codarsnachta mar issues ar an toradh; mura bhfuil aon toradh ann, bíonn an réimse ar iarraidh. Glacann client.codes.imageUrl() le fg, bg agus ecc. Gach cód a sheolann an API ar ais (get, list, create, update, batchCreate), bíonn title agus appearance aige.
  • Nuashonrú: npm install @qr3/sdk@latest. Leanfaidh Python, Go agus PHP. Sonraí: SDKanna & CLI agus Dathanna a shábháil ar an gcód.

2026-09 · Tá feidhm ag am éaga athraithe laistigh de thart ar nóiméad amháin

  • Réitithe: Glanann PATCH ar expires_at taisce atreoraithe an chóid anois. Dá bhrí sin, tá feidhm ag an am éaga nua laistigh de thart ar nóiméad amháin in ionad suas le 24 uair an chloig níos déanaí. Roimhe seo, d’fhillfeadh am éaga a baineadh nó a cuireadh siar 410 ar feadh suas le 24 uair an chloig eile, agus choinnigh am éaga a socraíodh don am i láthair an t-atreorú ag rith ar feadh suas le 24 uair an chloig eile.
  • Réitithe: Éagann cód a cruthaíodh le expires_at in am freisin, fiú má tá an t-am éaga laistigh den chéad 24 uair an chloig.
  • Réitithe: Má scriostar cód le linn dá lógó a bheith á uaslódáil nó á bhaint, freagraíonn POST agus DELETE /v1/codes/:id/logo le 404 agus ní athraíonn siad an cód scriosta, mar a dhéanann PATCH cheana féin.
  • Réitithe: Stóráiltear cód statach freisin sa taisce atreoraithe nuair a dhéantar rochtain ar a ghearr-nasc (redirect_url). Glanann athrú, cur ar sos agus scriosadh é anois freisin, ní hamháin i gcás cóid dhinimiciúla.

2026-09 · Dathanna a shábháil ar an gcód

  • Nua: Glacann PATCH /v1/codes/:id le appearance ina bhfuil foreground_color agus background_color (#RRGGBB, an cúlra chomh maith le transparent). Tarraingíonn qr.svg agus qr.png na dathanna stóráilte gan aon pharaiméadar; tá tosaíocht fós ag paraiméadar cosúil le ?fg=000000. Ní tharraingeoidh PDF agus EPS dathanna ach le heisiúint níos déanaí.
  • Seiceáil codarsnachta: Ginfidh péire faoi bhun 1,5:1 earráid 422. Sábhálfar péirí níos laige agus tuairisceofar iad in meta.issues mar warning nó critical; bíonn cúlra trédhearcach i gcónaí mar critical, ní chuirtear bac air riamh.
  • Cumasc: Coinníonn réimsí a fágadh ar lár a luach sábháilte, athshocraíonn null é. Ní scríobhann athruithe comhuaineacha ar an gcód céanna thar a chéile a thuilleadh.
  • I ngach freagra cóid: Tá appearance san áireamh i ngach freagra cóid agus sna webhooks qr.created agus qr.updated. Diúltaíonn POST, an baisc-phróiseas agus an t-allmhairiú dó le 422.
  • Gan aon athrú ar chóid reatha: Gan dathanna sábháilte, soláthraíonn gach cód na bearta céanna is a bhí roimhe seo. Sonraí: Dathanna a shábháil ar an gcód.

2026-09 · Dathanna agus ceartú earráidí mar pharaiméadair do na ródanna íomhá

  • Nua: Glacann na ceithre ród íomhá go léir le fg (dath tulra), bg (dath cúlra nó transparent) agus ecc (ceartú earráidí L, M, Q, H). Tarraingíonn SVG agus PNG na dathanna; glacann PDF agus EPS leo, ach ní tharraingeoidh siad iad go dtí scaoileadh níos déanaí. Oibríonn ecc sna ceithre fhormáid go léir, éilíonn lógó H i gcónaí.
  • Trédhearcach: Soláthraíonn bg=transparent SVG gan cúlra agus PNG le fíor-chainéal alfa. Caithfidh an dromchla thíos a bheith geal agus an crios ciúnais a fhágáil saor.
  • Ní earráid choíche: Déantar neamhaird de luachanna neamhbhailí; soláthraítear an íomhá ansin díreach mar a bheadh sí gan pharaiméadair.
  • Taisce: Soláthraíonn gach paraiméadar éifeachtach Cache-Control: public, max-age=300 in ionad an 24 uair an chloig den íomhá chaighdeánach.
  • Gan aon athrú iompraíochta gan pharaiméadair: Soláthraíonn gach cód reatha na bearta céanna i ngach ceann de na ceithre fhormáid is a bhí roimhe seo.
  • Ar fáil i ngach plean. Sonraí: Dathanna agus ceartú earráidí.

2026-09 · Leabaíonn PDF agus EPS an lógó anois freisin

  • Síneadh: Leabaíonn qr.pdf agus qr.eps lógó socraithe anois ar an mbealach céanna le qr.svg agus qr.png (féach thíos) — mar íomhá leabaithe (PDF trí Image XObject, EPS trí fhoclóir íomhá i PostScript, ansin amháin le %%LanguageLevel: 3), lárnaithe ar an limistéar céanna, leis an ardú céanna ar an gceartúchán earráidí go H. Níor chuir an dá fhormáid an lógó ar fáil roimhe seo; tá sé seo réitithe anois.
  • Taisce: Nuair a bhíonn lógó socraithe, seachadann qr.pdf agus qr.eps anois Cache-Control: public, max-age=300 freisin in ionad an ghnáth-24 uair an chloig — go díreach cosúil le SVG/PNG.
  • Cúltaca: Mura féidir an íomhá lógó féin a phróiseáil (mar shampla réad stóráilte atá damáistithe), fanann an ceartúchán earráidí ag H, ach fanann an limistéar coinnithe folamh in ionad íomhá — ní tharlaíonn earráid fhreastalaí riamh.
  • Gan aon athrú iompraíochta gan lógó: Leanann cóid gan lógó ag seachadadh qr.pdf/qr.eps atá comhionann ó thaobh beití de, le taisce 24 uair an chloig gan athrú.
  • Sonraí agus treoracha priontála: Lógó i gCód QR.

2026-09 · Lógó i gCód QR — Deais agus API

  • Nua: Is féidir le cód lógó sa lár a bheith aige anois. Sa Deais, cruthaíonn leathanach mionsonraí cóid cárta lógó dá chuid féin: Roghnaigh lógó, deimhnigh rabhadh le ticbhosca éigeantach nuair a chuirtear leis den chéad uair é nó nuair a bhaintear é (athraíonn an dá rud an patrún poncanna), ansin Uaslódáil lógó/Bain lógó. Níl deimhniú de dhíth le haghaidh Athsholáthar — ní athraíonn ach an íomhá, ní an patrún. Feiceann an ról viewer an stádas agus an réamhamharc, ach ní fheiceann sé aon cheann den trí ghníomh.
  • API: POST /v1/codes/{id}/logo (réimse ilpháirteach file; PNG, JPEG nó WebP, uasmhéid 1 MB, diúltaítear do SVG) cruthaíonn nó athsholáthraíonn sé lógó; baineann DELETE /v1/codes/{id}/logo as arís é agus tá sé idimpotúil. Seolann íomhá atá ró-mhór 413 ar ais, seolann formáid nach dtacaítear léi 422, agus seolann an ról viewer 403.
  • Rindreáil: Leabaíonn qr.svg agus qr.png an lógó mar phicsail iarbhír (512 × 512, normalaithe) agus ardaíonn siad an ceartúchán earráidí go H chuige sin. Athraíonn cur leis agus baint an patrún poncanna dá bharr (M ↔ H), ach ní athraíonn athsholáthar é. Ní leabaíonn qr.pdf agus qr.eps aon lógó agus fanann siad gan athrú. Leanann cód atá clóite cheana féin ag feidhmiú ar aon chuma, toisc nach bhfuil an sprioc chódaithe ag brath ar an lógó — ní gá ach dóibh siúd athchló a dhéanamh ar mian leo cuma an lógó (nua) a fheiceáil ar an ábhar freisin, agus gan seanchomhaid agus comhaid nua cló a mheascadh le linn an phróisis sin.
  • Taisce: Nuair a bhíonn lógó socraithe, seolann qr.svg agus qr.png Cache-Control: public, max-age=300 in ionad an ghnáth-24 uair an chloig. Sonraí, teorainneacha agus treoracha clóbhuailte: Lógó i gCód QR.

2026-08 · operationId do na 75 oibríocht ar fad, agus treoir “Cathain” d’oibreáin

  • Breisiú: Tá operationId anois ar gach ceann den 75 oibríocht sa sonraíocht OpenAPI — listCodes, createCode, getCodeStats, archiveWorkspace agus mar sin de. Go dtí seo, bhí an réimse seo ar iarraidh go hiomlán, ionas go mbíodh ar gach gineadóir ainm an mhodha a dhíorthú ón modh HTTP agus ón gcosán (postV1Codes). Bíonn ainmneacha den sórt sin ag brath ar an gcosán agus athraíonn siad le gach athstruchtúrú cosáin. Tá formáid an ainm mar an gcéanna sna 75 áit ar fad: list/get/create/update/replace/delete, nó ar shlí eile briathar na gníomhaíochta gnó (validateDpp, registerGs1Identifier, pingWebhook). Leanann an briathar an loighic ghnó, ní an modh HTTP — is DELETE é archiveWorkspace, is POST é importDpps.
  • Tionchar ar chliaint fhéinghinbhithe: Gach duine a ghineann a SDK ón sonraíocht, gheobhaidh siad modhanna athainmnithe ar an gcéad rith eile (postV1Codes → createCode). Is é sin cuspóir an athraithe, ach is athainmniú i gcód seachtrach é — mar sin luaitear go sainráite anseo é. Tá cosáin, paraiméadair, formáidí freagartha agus cóid stádais gan athrú; ní dhéantar difear do na SDKs oifigiúla, don CLI ná don fhreastalaí MCP.
  • Iontráil d’Oibreáin: Tá rannán ## When to use qr3.app ag https://qr3.app/llms.txt — sé thasc in ionad sé fheidhm, móide an abairt faoi cad chuige nach é qr3.app an uirlis cheart. Soláthraíonn an freastalaí MCP an t-eolas céanna anois sa chroitheadh láimhe: freagraíonn initialize i gcoinne https://mcp.qr3.app/mcp le réimse instructions (roimhe seo: aon uirlis déag gan aon aicmiú). Tá sé san áireamh freisin cé na glaonna a dteastaíonn eochair API uathu — ní theastaíonn ceann ó initialize ná ó tools/list, ach teastaíonn ó gach tools/call.
  • Ceartúcháin in llms.txt: Tomhaiseadh ceithre ráiteas i gcoinne na táirgeachta agus ní raibh siad cruinn: (1) níl an SDK Python qr3app foilsithe ar PyPI — tá an líne pip install bainte amach gan athsholáthar; (2) tá feidhm ag Accept: text/markdown don leathanach baile agus don bhlag, ní do gach leathanach a rindreáiltear ar thaobh an fhreastalaí; (3) is é [email protected] an seoladh teagmhála, chomh maith leis an JSON-LD ar an leathanach baile; (4) is atreorú chuig ancaire é /de/security/, ní leathanach ar leith é. Nasctha as nua: docs.qr3.app/de/skills/.
  • Cosaint: Trí dhearbhú in openapi-spec.test.ts — iomláine, uathúlacht, lowerCamelCase —, gach ceann acu croscheadaithe le sóchán. Coinníonn naoi dtástáil eile na ceithre ráiteas ceartaithe slán ionas nach bhfillfidh siad.
  • Teorainn ar eolas: Tá dhá cheann den 75 oibríocht curtha síos sa tsonraíocht, ach freagraíonn siad le 404 (GET /v1/codes/{id}/stats agus GET /v1/account). Tugadh ainm dóibh anseo agus caillfidh siad arís é chomh luath agus a chinnfear an ndéanfar iad a thógáil nó a scriosadh.

2026-08 · Bíonn tionchar ag íosghráduithe pleananna agus cealuithe ar na teorainneacha anois freisin

  • Deisiúchán: Níor scríobh an webhook Stripe ach ainm an phlean le linn athrú plean agus cealú, seachas na ceithre cholún teorann de chuid na heagraíochta (max_workspaces, max_members, max_dynamic_codes, max_scans_per_month). Ós rud é go dtógann an forfheidhmiú an t-uasmhéid den luach sábháilte agus de bhunlíne an phlean, choinnigh eagraíocht a d’íosghrádaigh nó a chealaigh a seanteorainneacha níos airde — bhí an t-íosghrádú gan éifeacht. Socraíonn an webhook na colúin anois ag gach fíor-athrú plean go dtí bunlíne an phlean nua, agus ar chealú go dtí an bhunlíne Free — díreach mar a dhéanann an riarachán riarthóra cheana féin.
  • Iompar: Ní chuireann nuashonruithe gnáthaimh ar an síntiús (athnuachan, modh íocaíochta, proration) isteach ar na teorainneacha fós; maireann teorainneacha níos airde a deonaíodh ina n-aonar gan athrú. Ní athraíonn ach fíor-athrú plean iad go dtí bunlíne an phlean nua.
  • Tionchar: Gan aon athrú ar API nó ar fhormáid freagartha. Coinníonn eagraíochtaí a raibh a n-íosghrádú roimh an deisiúchán seo na seandluachanna, go dtí go dtiocfaidh an chéad athrú plean eile i bhfeidhm nó go ndéanann an tacaíocht iad a choigeartú.

2026-08 · Cúrsóir Keyset anois ar gach críochphointe liosta

  • Deisiúchán: Tá an deisiúchán cúrsóra do GET /v1/codes agus GET /v1/dpp (féach thíos) curtha i bhfeidhm anois ar gach liosta eile atá leathanachaithe le cúrsóir: GET /v1/qr-codes/:id/comments, /v1/workspaces, /v1/gs1/identifiers, /v1/members, /v1/audit-logs, /v1/admin/orgs, /v1/admin/users agus /v1/webhooks/:id/deliveries. Bhí gach ceann acu ag leathanachú bunaithe ar created_at amháin; d’fhéadfadh sraitheanna a raibh an stampa ama céanna acu (iontrálacha iniúchta d’oibríocht bhaisc, atriallta Webhook, iompórtálacha ball) a bheith caillte ar an gcéad leathanach eile. Is é an eochair sórtála i ngach áit anois ná an túpal (created_at, id).
  • Athrú API: Ar na liostaí seo, is luach teimhneach (base64url) é meta.pagination.next_cursor as seo amach freisin in ionad stampa ama lom; seolann cúrsóirí nach féidir a léamh 400 ar ais, agus glacfar le seanchúrsóirí stampa ama go sealadach le linn na hidirthréimhse. Eisceacht is ea GET /v1/webhooks/:id/deliveries: ansin fanann next_cursor mar ID an tseachadta dheireanaigh (ID anaithnid → an chéad leathanach). Ní gá do chliaint a sheolann next_cursor ar ais gan athrú — Deais, CLI, SDKs, MCP — aon rud a athrú.
  • Tionchar: Níl aon imirce ag teastáil. Má bhí iontrálacha ar iarraidh ort agus tú ag leathanachú trí cheann de na liostaí seo (m.sh. loga iniúchta nó loga seachadta sa Deais): Ní raibh siad imithe riamh — taispeánann na liostaí go hiomlán iad as seo amach.

2026-08 · Stampaí ama comhlíontacha le OpenAPI arís tar éis eagarthóireachta agus scriosta

  • Deisiúchán: Tar éis PATCH /v1/codes/{id}, d’fhill updated_at i bhformáid SQLite gan crios ama (2026-08-17 09:00:00), cé go ngeallann an tsonraíocht OpenAPI format: date-time agus go soláthraíonn cruthú (POST) an stampa ama ISO (2026-08-17T09:00:00.000Z). Bhain an rud céanna le deleted_at/updated_at le linn soft-delete chomh maith leis na cosáin eagarthóireachta/scriosta le haghaidh eochracha API, eagraíochtaí, Workspaces, ball, tráchtanna agus Webhooks, chomh maith le last_used_at de chuid eochracha API agus last_triggered_at de chuid Webhooks. Stampálann gach cosán scríofa ISO 8601 (UTC, T agus Z) anois.
  • Tionchar: Cliaint a pharsálann updated_at le new Date(...) (SDKs, CLI, Deais), léigh siad an fhormáid spáis mar am áitiúil — thaispeáin an CLI an t-am aistrithe de réir an fhritháireamh áitiúil do chóid a ndearnadh eagarthóireacht orthu uair amháin (Vín: −2 h). Tá sé seo réitithe. Ina theannta sin, déanann imirce sonraí luachanna atá stóráilte cheana féin sa tseanfhormáid a normalú go ISO, ionas go mbeidh an sórtáil agus na comparáidí cruinn i dtiomsacháin mheasctha. Níl aon athrú ar ainmneacha réimsí ná ar struchtúr an fhreagra.
  • Cúlra: An aicme earráide chéanna leis an dá dheisiúchán thíos (dul in éag eochrach API, teorainn athscanta): scríobhann datetime('now') de chuid SQLite YYYY-MM-DD HH:MM:SS, agus scríobhann gach scríbhneoir eile ISO 8601. Coscfaidh tástáil cosanta bunchóid tarluithe nua amach anseo.

2026-08 · Ní chailleann leathanachú liostaí cóid bhaisc a thuilleadh

  • Deisiúchán: Bhíodh GET /v1/codes agus GET /v1/dpp ag déanamh leathanachú bunaithe ar created_at amháin. Ach roinneann cóid ó POST /v1/codes/batch, POST /v1/dpp/batch agus an iompórtáil CSV/XLSX stampa ama amháin — a luaithe a bhí baisc níos mó ná limit (réamhshocrú 20), níor sheol an dara leathanach na línte eile den stampa ama céanna ar ais a thuilleadh. Bhí na cóid ann agus bhí teacht orthu trí GET /v1/codes/:id, ach níor tháinig siad chun solais sa liosta (Deais, CLI qr3 list, SDKs, MCP) riamh. Is eochairshraith (keyset) anois é an cúrsóir thar (created_at, id).
  • Athrú API: Is luach teimhneach (base64url) anois é meta.pagination.next_cursor in ionad stampa ama lom. Aon duine a sheolann an cúrsóir ar ais gan athrú mar ?cursor= — mar a dhéanann an Deais, an CLI, gach SDK agus an freastalaí MCP — ní gá dóibh aon rud a athrú. Glacfar le seanchúrsóirí stampa ama fós le linn idirthréimhse; seolann cúrsóirí nach féidir a léamh 400 ar ais anois in ionad an chéad leathanach a thaispeáint go ciúin.
  • Tionchar: Má chonaic tú níos lú cóid sa liosta tar éis iompórtáil bhaisce ná mar a cruthaíodh: Ní raibh na cóid imithe riamh — taispeánann an liosta go hiomlán iad as seo amach. Níl aon imirce ag teastáil.

2026-08 · Athscanta slándála ag rith arís ar thimthriall 24 uair an chloig

  • Deisiúchán: Bhí an t-athscanadh tréimhsiúil ar URLanna sprice agus ar naisc leathanach tulaigh (Google Web Risk) ag scipeáil cóid a raibh a scanadh deireanach ar an lá féilire céanna leis an teorainn 24 uair an chloig — ag brath ar an am, cuireadh moill suas le lá eile ar an athscanadh. Déantar an teorainn a ríomh anois san fhormáid ISO chéanna ina stóráiltear stampaí ama an scanta.
  • Tionchar: Má rangaítear URL sprice mar URL neamhshábháilte tar éis an scanta dheireanaigh, cuirfear an cód ar sos go huathoibríoch arís laistigh den fhuinneog dhoiciméadaithe 24 uair an chloig. Níl aon athrú ar an API ná ar fhormáid an fhreagra.

2026-08 · Éagann eochracha API ag an am éaga

  • Deisiúchán: Glacadh fós le heochair API, a raibh a expires_at ar an lá céanna, go dtí meán oíche UTC. Déantar an t-éag a chur i gcomparáid anois mar stampa ama seachas mar theaghrán — filleann eochair atá éagtha 401 láithreach.
  • Cúlra: Stóráiltear expires_at mar stampa ama ISO (2026-08-14T09:00:00Z), ach sholáthair an taobh comparáide an fhormáid spáis (2026-08-14 09:00:00). Dá bhrí sin, ní raibh an chomparáid amhtheaghráin cruinn ach chomh fada is a bhí difríocht sa dáta cheana féin.
  • Tionchar: Níl aon imirce ag teastáil, fanann formáid freagartha GET /v1/api-keys gan athrú. Meastar anois go bhfuil luachanna éaga nach féidir a léamh éagtha seachas bailí.

2026-08 · Tagairt API: Bainistiú Tionóntaí Doiciméadaithe

  • OpenAPI: Doiciméadaíonn an tsonraíocht — agus dá bhrí sin an tagairt idirghníomhach — anois Eagraíochtaí (lena n-áirítear GET /v1/organizations/usage), Workspaces, Baill & Róil agus Logaí Iniúchta.
  • Billing: Tá an forbhreathnú ar phleananna (GET /v1/billing/plans) poiblí; tá Checkout (POST /v1/billing/checkout) agus tairseach custaiméirí Stripe (GET /v1/billing/portal) ainmnithe mar phointí deiridh do riarthóirí eagraíochta.
  • Easpórtáil scanta: Tá staitisticí scanta (GET /v1/codes/{id}/scans) agus easpórtáil na n-amhshonraí (…/scans.csv, …/scans.xlsx) doiciméadaithe go hiomlán — lena n-áirítear fógra GDPR: Ní bhíonn an ip_hash san áireamh san easpórtáil riamh.
  • Iompar earráidí: Tá freagra 400 an bhailíochtaithe iarratais doiciméadaithe as an nua freisin: Is é an corp an earráid amh Zod, ní doiciméad fadhbanna RFC-7807 é — mar sin féin, déantar é a sheachadadh faoin Content-Type application/problem+json.

2026-08 · Naisc phoiblí comhad a chóipeáil

  • Deais: Tá cnaipe anois ag comhaid phoiblí ar leathanach mionsonraí an chóid a chuireann a nasc poiblí ar an ngearrthaisce – réidh le húsáid mar sprioc-URL do chód QR nuair is mian leat go n-osclóidh scanadh doiciméad ar leith láithreach in ionad an leathanaigh tulaigh lena liosta comhad.
  • API: Filleann na críochphointí comhaid (/v1/files) public_url freisin. Níl an réimse socraithe ach ag comhaid a bhfuil visibility: public acu – ní bhfaigheann comhaid phríobháideacha seoladh poiblí.
  • Iompar: Ní éilíonn an nasc logáil isteach agus osclaíonn sé an comhad go díreach sa bhrabhsálaí. Fágann an cnaipe Ionadaigh an nasc gan athrú; mar sin fanann cód atá clóite leis bailí. Sonraí: Comhaid & Bileoga Sonraí.

2026-07 · Róil Foirne: Rannchuiditheoir gan scriosadh & Billeáil Riarthóra

  • Nua: Ról baill Rannchuiditheoir (gan scriosadh) — cruthaíonn agus cuireann sé cóid QR, comhaid agus Digital Product Passports in eagar, ach ní féidir leis aon rud a scriosadh ná eochracha API a chruthú. Seiceálann gach críochphointe millteach an ról ar thaobh an fhreastalaí (403).
  • Billeáil: Tá uasghráduithe pleananna agus tairseach custaiméirí Stripe (POST /v1/billing/checkout, GET /v1/billing/portal) teoranta anois do Riarthóirí eagraíochta — feiceann gach ról eile forbhreathnú inléite amháin ar an bplean.
  • Deais: Cuirtear gníomhartha nach gceadaíonn ról an úsáideora i bhfolach: ní fheiceann Breathnóir, mar shampla, cnaipí chun cruthú, eagarthóireacht nó scriosadh; fanann liostaí, íoslódálacha agus staitisticí infheicthe. Sonraí: Foireann & Róil.

2026-06 · Naisc sheachtracha ar leathanach tulaigh an chóid

  • Leathanach tulaigh: Is féidir le leathanach tulaigh cóid arna óstáil ag qr3 anois naisc sheachtracha féinóstáilte ({ label, url }) a liostáil chomh maith le comhaid uaslódáilte nó ina n-áit – mar shampla do bhileoga sonraí ar do shuíomh féin.
  • API: Glacann POST/PATCH /v1/codes le heagar links (0–20 iontráil, http(s), ≤ 2048 carachtar). Seiceáiltear gach URL le Google Web Risk; filleann URL neamhshábháilte 422. Glanann eagar folamh na naisc go léir.
  • Deais: Cuir naisc leis, athordaigh iad agus bain iad ar leathanach sonraí an chóid.
  • Slándáil: Fanann naisc rendáilte slán ó XSS (éalaithe, http(s) amháin) agus coinníonn an leathanach a cheanntásc noindex.

2026-04 · Analytics Deais in aghaidh an Chóid QR

  • Deais: Osclaíonn an cnaipe Analytics i liosta na gcód QR anois leathanach staitisticí an chóid QR ábhartha faoi /dashboard/codes/{id}.
  • Ródú: Atreoraíonn an t-alias /dashboard/codes fós chuig /dashboard, ach ní ghlacann sé níos mó le bealaí mionsonraithe cosúil le /dashboard/codes/{id}.
  • API: Lódálann an leathanach mionsonraí an cód QR go díreach trí GET /v1/codes/:id; mar sin níl sé ag brath a thuilleadh ar theorainneacha leathanachú liostaí.
  • Tástálacha: Clúdaíonn tástálacha aischéimnithe an t-atreorú alias agus lódáil dhíreach an chóid.

2026-04 · Dialóg Scriosta Deais do Chóid QR

  • Deais: Osclaíonn an deilbhín bruscair i liosta na gcód QR dialóg React tiomnaithe anois in ionad preabfhuinneog dhúchasach brabhsálaí.
  • Aiseolas: Tar éis scriosta, feictear teachtaireacht toast ratha nó earráide.
  • Tástálacha: Coscann packages/dashboard/tests/dashboard.test.ts aischéimnithe ar confirm() i sreabhadh scriosta an chóid QR.

2026-04 · Tástáil Nasc Gearr Deais do Chóid QR Dhinimiciúla

  • Deais: Is féidir cliceáil go díreach anois ar ghearrchóid i liosta na gcód QR mar naisc sheachtracha atreoraithe. Osclaíonn an deilbhín naisc sheachtraigh in aice le, m.sh., wu3qaa an nasc https://qr3.app/{shortCode} i gcluaisín nua.
  • i18n: Cuireadh téacsanna leid uirlise (tooltip) leis don Ghearmáinis agus don Bhéarla.
  • Tástálacha: Cosnaíonn packages/dashboard/tests/dashboard.test.ts href an naisc, iompar an chluaisín nua, noopener noreferrer agus an deilbhín in aghaidh aischéimnithe.

2026-04 · Bealach Redirect-Worker do Chóid QR Dhinimiciúla

  • Deisiúchán: Próiseálann an Redirect-Worker cóid QR dhinimiciúla faoi https://qr3.app/{shortCode} arís. Úsáideann an bealach táirgeachta qr3.app/* anois, toisc nach dtacaíonn bealaí Cloudflare Worker le paraiméadair chonair :code.
  • Neartú: Seoltar conairí nach meaitseálann ar aghaidh chuig bunús an leathanaigh tuirlingthe (landing origin), ionas nach gcuireann an Redirect-Worker bac ar ghnáthleathanaigh cosúil le /de/pricing.
  • Tástálacha: Seiceálann packages/redirect/tests/unit/redirect.test.ts an bealach saoróg (wildcard), próiseáil gearrchód agus pas-trí an bhunúis.

2026-04 · Foramharc Scanadh DPP an Spáis Oibre (Q3.4.2)

  • Nua: GET /v1/workspace/stats/dpp?days=30 — comhiomlánaíonn sé gach dpp_scans de chuid spás oibre an eochair API (active_dpps, scans_by_day, top_dpps le hainm an táirge/catagóir).
  • Deais: Cárta ar an leathanach baile (/dashboard) le barrachairt 30 lá + barrliostaí — i gcomhthreo leis na cártaí cóid QR.
  • Poiblí: Gearrnasc margaíochta GET /dpp/dpp_<id> (deighleog amháin) le haghaidh taispeántais bheo, i gcomhthreo le /dpp/{gtin}/{serial}.

2026-04 · Analytics Scanadh DPP (Q3.4.1)

  • Nua: GET /v1/dpp/:id/stats?days=30 — scananna comhiomlánaithe an réiteora phoiblí GS1 in aghaidh an DPP. Réimsí: total_scans, period_scans, scans_by_day, top_countries, top_devices, top_representations.
  • Nua: Tábla dpp_scans (Imirce 0011) — scartha ó scans (Redirect-Worker). Déantar seoltaí IP a haiseáil le salt a rothlaíonn go laethúil, ní shroicheann seoltaí IP amha D1 riamh.
  • Deais: Mionchárta cairte (SVG, gan leabharlann chairte) ar /dashboard/dpp/:dppId le barraí 30 lá + miondealuithe barr 3. Staid fholamh chomh luath agus a bhíonn DPP beo ach nach raibh aon scanadh aige fós.

2026-04 · Insamhlóir Comhlíonta AE Beo (Q3.3.7)

  • Nua: POST /v1/dpp/:id/validate-update — insamhlaíonn sé nuashonruithe páirteacha gan staid (stádas, liosta margaí, …) gan seasmhacht. Tá eu_compliance + preview.changed_fields sa fhreagra.
  • Deais: Cárta insamhlóra i mionsonraí an DPP (/dashboard/dpp/:dppId) — sliseanna do DE/AT/FR/IT/ES/NL + Custom, anuasán stádais, Preview EU impact / Save changes / Reset. Neamhbhacach trí Remix useFetcher.
  • Neartú: Cuntóirí insamhlóra seachtraithe (readUpdatePatchFromForm, marketCountriesKey) + 18 dtástáil aonaid nua; Deisiúchán fabhtanna: Ní scriosann ionchur aonair neamh-ISO an liosta margaí a thuilleadh.

2026-04 · Réamhamharc Comhlíonta AE Beo san Fhoirm Chruthaithe (Q3.3.6)

  • Athraithe: Soláthraíonn POST /v1/dpp/validate eu_compliance freisin — an bailíochtóir céanna le GET /v1/dpp/:id/eu-compliance, gan staid roimh shábháil.
  • Deais: Réamhamharc faoin bpainéal bailíochtaithe reatha + bratach cosanta sábhála nua roimh na cnaipí seolta, má tá earráidí/rabhaidh oscailte (iolrú i18n DE/EN).

2026-04 · Bailíochtóir AE + UI Teicstíle (Q3.3.4 + Q3.3.5)

  • Nua: Bailíochtóir comhlíonta AE le 5 riail teicstíle (TEXTILE_AGEC_REQUIRED, TEXTILE_MICROPLASTICS_CONSISTENCY, TEXTILE_SVHC_THRESHOLD, TEXTILE_GREENWASHING, TEXTILE_ESPR_READY).
  • Nua: GET /v1/dpp/:id/eu-compliance le compliant / espr_ready / issues[] / summary.
  • Deais: Rannóg comhlíonta AE i mionsonraí an DPP (tíleanna achoimre, cártaí fadhbanna grúpáilte, suaitheantas ESPR-Ready sa cheanntásc).

2026-04 · Scéimre DPP Teicstíle (Q3.3.1–Q3.3.3)

  • Nua: Catagóir textile le slabhra éigeantach AGEC (Fíodóireacht/Cniotáil → Ruaimniú/Priontáil → Déantús), in aghaidh an tsnáithín origin_country + recycled_pct, svhc_substances[], rogha isteach (opt-in) ESPR (PEF, saolré, in-athchúrsáilteacht).
  • Nua: Bunréimse market_countries: string[] (ISO 3166-1 alpha-2) ar gach catagóir DPP — rialaíonn sé rialacha AGEC a bhaineann go sonrach leis an bhFrainc agus an nóta éigeantach tomhaltóra sa Fhraincis.
  • Nua: Teimpléad HTML tomhaltóra le bosca rabhaidh micreaplaisteach AGEC, slabhra tionscnaimh 3 chéim (pills bratach), liosta SVHC, rannóg marthanachta (durability) agus in-athchúrsáilteachta (recyclability).
  • Imirce: 0010_dpp_market_countries (D1).

2026-04 · Bulciompórtáil DPP (Q3.2.1–Q3.2.5)

  • Nua: Glacann POST /v1/dpp/import le CSV agus XLSX (comhoiriúnach le Worker trí SheetJS xlsx, bundle gzip ~283 KB).
  • Scálaithe: teorainn bunaithe ar phlean (Free 100 → Enterprise 10k) + db.batch() roinnte ina smután (chunked) de 100 + teorainn choirp 5 MB.
  • Nua: Tuarascáil earráide mar CSV sa réimse errors_csv den fhreagra 201; soláthraíonn GET /v1/dpp/import/templates/:category?format=csv|xlsx teimpléid réidh le haghaidh ceallraí agus teicstíle.
  • Deais: Uaslódáil tarraing-agus-scaoil faoi /dashboard/dpp/import le seachfhreastalaí teimpléid (template proxy) agus íoslódáil CSV inlíne.

Neamh-bhrisidh — Eisínteachtaí LTS

Tá na athruithe go léir thuasluaite breise:

  • Déanann cliaint reatha POST /v1/dpp/validate neamhaird den réimse nua eu_compliance gan aon athrú.
  • Tá sreafaí reatha battery gan athrú.
  • Tá market_countries roghnach agus réamhshocraítear é ar [].

Féach ar Leaganú API don pholasaí um athruithe briste.