Bogadóireacht le API

Tá gach cuid de Nordlet ar fáil trí aon API JSON amháin, mar aon le trealamh forbartha (SDK), ríomh-bhéicí (webhooks), athsheachaintí díonmhacha (idempotent retries) agus freastalaí MCP do chúntóirí AI.

Is éard atá in API (comhéadan ríomhchlárúcháin feidhmchláir) ná bealach le ligean do chlár amháin cumarsáid a dhéanamh le clár eile. Ligeann API cuntasaíochta do do bhogearraí féin sonrascanna a chruthować, íocaíochtaí a thaifeadadh agus tuairiscí a léamh, gan duine ar bith a bheith ag cliceáil trí scáileáin.

Is bogearraí cuntasaíochta iad Nordlet arb é an API an príomhbhealach isteach iontu. Tá gach rud a dhéanann an feidhmchlár gréasáin ar fáil tríd an API JSON céanna. Tá an leathanach seo dírithe ar fhorbróirí agus orthu siúd a dhéanann cinneadh faoi cad a nascann a dtáirge leis.

Cad a dhéanann Nordlet

Cruth aonair iarratais. Is éard atá i gcach glao ná POST /v1/{module}/{resource}/{action} le corp JSON, mar shampla sales/invoices/create vagy bank/transactions/match.
Eochracha API le raonta feidhme. Baineann gach eochair le cuideachta amháin agus tá raonta feidhme aici amhail sales:read nó bank:write. Faigheann eochair nach bhfuil an raon feidhme riachtanach aici freagra 403.
Airgead mar théacs. Is teaghráin dheachúlacha iad na suimeanna le suas le 4 áit dheachúlacha, gan a bheith ina n-uimhreacha snámhphointe riamh, ionas nach gcailltear aon cent mar gheall ar shlánú.
Formáid earráide amháin. Tá an timfheall céanna ag gach earráid le cód, teachtaireacht agus aithne iarratais.
Ceisteanna liosta comhroinnte. Glacann gach glao list leis na réimsí leathanaigh, sórtála agus scagtha céanna, agus is féidir leis suim iomlán a thabhairt ar ais.
Fíorialacha cuntasaíochta. Caithfidh iontrálacha irise cothromú a dhéanamh, níl aon bhearnaí i n-uimhreacha doiciméad, agus diúltaíonn tréimhse chuntasaíochta ghlasáilte do phostálacha nua le freagra 409. Scríobhtar gach athrú chuig loga iniúchta.

Athsheachaintí sábháilte le díonmhacht (idempotency)

Is féidir le líonra teip tar éis do d'iarratas a bheith próiseáilte ach sula bhfuair tú an freagra. D'fhéadfadh athsheachaint ansin an sonrasc céanna a chruthować faoi dhó. Ciallaíonn díonmhacht (idempotency) go bhfuil an éifeacht chéanna ag iarratas athchleachtach agus a bhí ag an gcéad ceann.

Seol ceanntásc Idempotency-Key le haon ghlao a athraíonn sonraí.
Faigheann athsheachaint leis an eochair chéanna agus an corp céanna an freagra stóráilte ar ais, le x-idempotent-replay: true.
Diúltaítear don eochair chéanna le corp difriúil.
Coinnítear eochracha ar feadh 24 uair an chloig.

Ríomh-bhéicí (Webhooks)

Is teachtaireacht í ríomh-bhéic (webhook) a sheolann Nordlet chuig do fhreastalaí nuair a tharlaíonn rud éigin, amhail sale_invoice.paid.

Scríobhtar imeachtaí san idirbheart bunachar sonraí céanna leis an athrú, agus mar sin ní sheolann athrú a ndéantar rolladh siar air aon imeacht.
Sínítear gach seachadadh le HMAC-SHA256 ag baint úsáide as do rún síntiús, ionas gur féidir leat a sheiceáil gur tháinig sé ó Nordlet.
Déantar iarracht arís ar sheachadadh teipthe ar feadh thart ar 24 uair an chloig. Is féidir leat é a sheoladh arís de láimh freisin.
Bainistítear síntiúis faoi Account → Webhooks nó tríd an API.

Uirlisí d'fhorbróirí

Tagairt API. Tagairt API idirghníomhach a tógadh ó chur síos OpenAPI, mar aon le bailiúchán Postman.
Trealamh forbartha (SDK). Cliaint chineálaithe do TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift agus Rust, ginte ón tuairisc chéanna. Féach ar an treoir SDK.
Freastalaí MCP. Is féidir le cúntóirí AI amhail Claude an API a chuardach agus a ghlaoch le do eochair API. Féach ar an treoir freastalaí MCP.
Cuideachtaí dumhcha gainimh (sandbox). Oibríonn cuideachta thástála cosúil le ceann fíor, tá sí marcáilte mar shonraí tástála, agus seolann sí comhdúcháin agus r-shonrascanna chuig críochnwphointí tástála na n-riarachán amháin.
Teorainn ráta. 300 iarratas in aghaidh an nóiméid in aghaidh na heochrach API, le ceanntáisc a thaispeánann cad atá fágtha.

Ceisteanna coitianta

Cad is féidir liom a dhéanamh tríd an API?

Gach rud sa táirge: sonrascadh, ceannacháin, an mórleabhar ginearálta, comhoiriúnú bainc, stoc, sócmhainní, párolla, tuairiscí agus comhdúcháin tíre. Téann an treoir thosaithe tríd an timthriall iomlán ó shonrasc go figiúirí CBL.

An féidir liom cuntasaíocht a thógáil isteach i mo tháirge féin?

Is féidir. Tá a leabhair féin ag gach cuideachta in Nordlet, agus oibríonn do bhogearraí orthu sin trína eochair API. Níl aon ghlao san API a chuireann in eagar nó a scriosann iontráil irise postáilte. Is iontráil nua í ceartúchán, rud a choinníonn mórleabhar dobhogtha.