API Finance.HDdev
Integrējiet Finance.HDdev savos rīkos. Piekļūstiet saviem kontiem, darījumiem, budžetiem un kategorijām caur vienkāršu un drošu REST API.
Autentifikācija
Bearer tokens (JWT). Iegūstiet savu tokenu no personīgā paneļa konta iestatījumos.
Bāzes URL
Visi pieprasījumi izmanto šādu bāzes URL:
https://finance.hddev.eu/api/v1Formāts
Visi pieprasījumi un atbildes izmanto JSON formātu. Nepieciešamais galvenes ieraksts: Content-Type: application/json
Autentifikācijas piemērs
curl -X GET https://finance.hddev.eu/api/v1/accounts \ -H "Authorization: Bearer VOTRE_TOKEN_JWT" \ -H "Content-Type: application/json"
Pieejamie galapunkti
Galveno Finance.HDdev API galapunktu pārskats.
/api/v1/accountsSavienoto bankas kontu saraksts ar atlikumiem un metadatiem.
/api/v1/transactionsDarījumu saraksts ar filtriem (datums, kategorija, summa, konts).
/api/v1/budgetsBudžeti un mērķi ar pašreizējo progresu.
/api/v1/transactionsIzveidojiet manuālu darījumu (izdevums, ienākums vai pārskaitījums).
/api/v1/categoriesPieejamās kategorijas (sistēmas un pielāgotās).
Pieprasījumu ierobežojumi
API pieprasījumiem ir ātruma ierobežojumi, lai nodrošinātu pakalpojuma stabilitāti.
Pilna dokumentācija
Pilna interaktīvā dokumentācija (OpenAPI / Swagger) drīzumā būs pieejama. Tā iekļaus pieprasījumu un atbilžu shēmas, kļūdu kodus un detalizētus piemērus.
Drošība
Visi sakari ir šifrēti caur HTTPS/TLS. JWT tokeni beidzas pēc 30 minūtēm (automātiska atjaunošana caur atjaunošanas tokenu). API atbilst VDAR un nekad neatgriež bankas pieteikšanās datus.
Nepieciešama palīdzība ar API?
Mūsu tehniskā komanda ir pieejama, lai palīdzētu jums integrēt Finance.HDdev API jūsu rīkos un darbplūsmās.
Sazināties ar API komanduapi@hddev.eu
Arhitektūras principi un lietošana
Finance.HDdev API ir balstīts uz RESTful arhitektūru, padarot to paredzamu un ērti lietojamu. Visi pieprasījumi tiek veikti caur HTTPS, lai nodrošinātu apmainīto datu konfidencialitāti. Atbildes, kā arī POST un PUT pieprasījumu ķermeņi, ir sistemātiski formatēti JSON formātā. URL struktūra ir orientēta uz resursiem, ļaujot jums intuitīvi mijiedarboties ar dažādiem mūsu sistēmas objektiem, piemēram, kontiem, darījumiem vai budžetiem. Mēs piemērojam ātruma ierobežojumu sistēmu, lai nodrošinātu platformas stabilitāti visiem mūsu lietotājiem. Šo ierobežojumu detaļas ir norādītas katrā atbildes galvenē.
Galvenie galapunkti un lietošanas gadījumi
Mūsu API atklāj vairākus galapunktus, lai aptvertu visas finanšu pārvaldības funkcijas. Galapunkts `/transactions` ļauj uzskaitīt, filtrēt un iegūt katra darījuma detaļas, ideāli piemērots padziļinātai izdevumu analīzei. Ar `/accounts` jūs varat iegūt savienoto kontu sarakstu un to reāllaika atlikumus. Budžeta izsekošanai galapunkti `/budgets` un `/categories` sniedz pilnu kontroli pār izdevumu aplokšņu izveidi un uzraudzību. Visbeidzot, galapunkts `/goals` ļauj pārvaldīt savus uzkrājumu mērķus. Šie apvienotie rīki paver durvis daudzām lietojumprogrammām, no vienkārša datu eksporta skripta līdz pilnīgai mobilajai finanšu konsultēšanas lietotnei.
API autentifikācija un drošība
Drošība ir mūsu absolūtā prioritāte. API piekļuve ir aizsargāta ar personīgajām autentifikācijas atslēgām, kuras varat ģenerēt, pārvaldīt un atsaukt no sava lietotāja paneļa. Katram API pieprasījumam jāiekļauj jūsu API atslēga `Authorization` galvenē kā Bearer Token. Ir būtiski turēt šīs atslēgas slepenībā un nekad tās neatklāt klienta pusē (piemēram, pārlūka JavaScript kodā). Visi API savienojumi ir šifrēti ar TLS (SSL). Mēs arī iesakām izmantot tīmekļa āķus, lai saņemtu reāllaika paziņojumus par svarīgiem notikumiem, piemēram, jaunu darījumu, nevis nepārtraukti aptaujātu API, tādējādi samazinot pieprasījumu apjomu un optimizējot veiktspēju.