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-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ú — Painéal, 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, Painéal), 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 (Painéal, 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.
  • Painéal: 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.