Developers API & Widget
API Reference
GA

Ag tosú

Réamhrá

Míníonn an treoir seo conas Wealth Readera chomhtháthú: roghnaíonn an t-úsáideoir a bhanc, fíordheimhníonn sé, agus faigheann do chóras na sonraí normalaithe.

Sampla den toradh deiridh: https://widget.wealthreader.com/demo-all/

Sula dtosaíonn tú

Teastaíonn uait:

  • Tá clárú cuntais críochnaithe agat agus api_keya bheith agat.
  • Seisiún bordála leis an bhfoireann theicniúil. Cuir mise in áirithe ó Tacaíocht.
  • Déan cinneadh ar an gcineál comhtháthaithe (thíos).
  • Is HTTPS le URL an callbacka fháil, má chomhtháthaíonn tú trí iframe.

Roghnaigh an cineál comhtháthaithe

Critéir Iframe (giuirléid) OAuth
Cathain Feidhmchlár Gréasáin ar féidir leis iframe a leabú Aip dhúchasach, nó ní féidir leat iframe a leabú
Tosaigh Leabaíonn tú an ghiuirléid ar do leathanach Atreoraíonn tú an t-úsáideoir chuig oauth.wealthreader.com
Sonraí Tagann siad POST chuig do URL callback Faigheann tú iad tríd an dúshlán a chríochnú i /token/
Tosaigh le Iframe: frontend OAuth: inneall

Úsáideann an chuid is mó de na cliaint gréasáin iframe.

An gcláraíonn tú le cúntóir AI? Suiteáil an Wealth Reader scil i Claude Code, Codex, Cursor, Copilot nó Gemini CLI agus gineann sé an comhtháthú tríd an treoir seo a leanúint.

Conas a oibríonn sé (iframe)

  1. Luchtaíonn do leathanach an ghiuirléid le operation_id a ghineann tú.
  2. Roghnaíonn an t-úsáideoir an t-eintiteas, tugann sé toiliú, agus réitíonn sé an dá fhachtóir más gá. Bainistíonn an ghiuirléid na céimeanna sin.
  3. Wealth Reader faigheann sé na sonraí agus déanann sé dhá rud, san ord seo:
    • Ar an backend, seolann Wealth Reader an JSON iomlán chuig an URL callback a shocraigh tú. Taistealaíonn an operation_id sa fhreagra sin ionas gur féidir leat é a chomhcheangal le d'oibríocht tosaigh.
    • Ar an frontend, tugann an iframe foláireamh do do leathanach le postMessage (flow completed) ach amháin má d'fhreagair an callback i gceart. Bain úsáid as chun an roghnóir a dhúnadh nó scáileán rathúlachta a thaispeáint.

Is é an operation_id an droichead idir tosaigh agus cúl. Gan é, ní féidir leat crostagairt a dhéanamh don rud a tharla sa bhrabhsálaí leis na sonraí a thagann ar do fhreastalaí.

Níl na sonraí bainc sa teachtaireacht flow completed . Taistealaíonn na sonraí chuig an callback. Mura bhfreagraíonn an callback HTTP 200 le {"status":"ok"}, ní fhaigheann an tosaigh flow completed.

Nuashonraithe