Developers API & Widget
API Reference
GA

Ag tosú

Réamhrá

Míníonn an treoir seo conas Wealth Reader a chomhtháthú: roghnaíonn an t-úsáideoir a bhanc, déanann sé fíordheimhniú, 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:

  • Clárú críochnaithe agus api_key.
  • Seisiún ionduchtúcháin leis an bhfoireann theicniúil. Cuir an ceann agatsa in áirithe ó Thacaíocht.
  • Cinneadh a dhéanamh ar an gcineál comhtháthaithe (thíos).
  • URL HTTPS a fhaigheann an callback, má chomhtháthaíonn tú trí iframe.

Roghnaigh an cineál comhtháthaithe

Critéar Iframe (widget) OAuth
Cathain Aip ghréasáin ar féidir iframe a leabú inti Aip dhúchais, nó ní féidir leat iframe a leabú
Frontend Cuireann tú an widget isteach ar do leathanach Atreoraíonn tú an t-úsáideoir chuig oauth.wealthreader.com
Sonraí Tagann siad mar POST chuig URL an callback agat Faigheann tú iad tríd an dúshlán ag /token/ a chur i gcrích
Tosaigh le Iframe: frontend OAuth: backend

Úsáideann formhór na gcliant gréasáin an iframe.

Conas a oibríonn sé (iframe)

  1. Luchtaíonn do leathanach an widget le operation_id a ghineann tú.
  2. Roghnaíonn an t-úsáideoir an institiúid, tugann toiliú agus déanann fíordheimhniú dhá fhachtóir más gá. Láimhseálann an widget na céimeanna sin.
  3. Faigheann Wealth Reader na sonraí agus déanann sé dhá rud, san ord seo:
    • Ar an backend, seolann sé an JSON iomlán chuig URL an callback a chumraigh tú. Téann an operation_id sa fhreagra sin ionas gur féidir leat é a mheaitseáil leis an oibríocht frontend.
    • Ar an frontend, cuireann an iframe do leathanach ar an eolas le postMessage (flow completed) ach amháin má d’éirigh leis an callback. Úsáid é sin chun an roghnóir a dhúnadh nó scáileán ratha a thaispeáint.

Is é an operation_id an droichead idir an frontend agus an backend. Gan é ní féidir leat an méid a tharla sa bhrabhsálaí a mheaitseáil leis na sonraí a thagann chuig do fhreastalaí.

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

Nuashonraithe