API Finance.HDdev
Integreerige Finance.HDdev oma toriistadesse. Paasege ligi oma kontodele, tehingutele, eelarvetele ja kategooriatele lihtsa ja turvalise REST API kaudu.
Autentimine
Bearer token (JWT). Hankige oma token isiklikust juhtpaneelist konto seadetes.
Baas-URL
Koik paringud kasutavad jargmist baas-URL-i:
https://finance.hddev.eu/api/v1Vorming
Koik paringud ja vastused kasutavad JSON-vormingut. Noutav paisevorming: Content-Type: application/json
Autentimise naside
curl -X GET https://finance.hddev.eu/api/v1/accounts \ -H "Authorization: Bearer VOTRE_TOKEN_JWT" \ -H "Content-Type: application/json"
Saadaolevad lopp-punktid
Ulevaade peamistest Finance.HDdev API lopp-punktidest.
/api/v1/accountsUhendatud pangakontode loend saldode ja metaandmetega.
/api/v1/transactionsTehingute loend filtritega (kuupaev, kategooria, summa, konto).
/api/v1/budgetsEelarved ja eesmargid koos praeguse edusammuga.
/api/v1/transactionsKasitehingu loomine (kulu, tulu voi ulekanne).
/api/v1/categoriesSaadaolevad kategooriad (susteemi- ja kohandatud).
Paringupiirangud
API paringuid piiratakse teenuse stabiilsuse tagamiseks.
Taiuslik dokumentatsioon
Taiuslik interaktiivne dokumentatsioon (OpenAPI / Swagger) on peagi saadaval. See sisaldab paringu- ja vastuseskeeme, veakoode ja uusiksjalikke nasideid.
Turvalisus
Koik side on kruuptitud HTTPS/TLS kaudu. JWT-tokenid aeguvad 30 minuti parast (automaatne uuendamine varskendamistokeni kaudu). API on GDPR-iga uhilduv ega tagasta kunagi pangamandaate.
Vajate abi API-ga?
Meie tehniline meeskond on valmis teid aitama Finance.HDdev API integreerimisel teie toriistadesse ja toovougu desse.
Votta API meeskonnaga uhendustapi@hddev.eu
Arhitektuuripohimotted ja kasutamine
Finance.HDdev API pohineb RESTful arhitektuuril, muutes selle ettearvatavaks ja lihtsasti kasutatavaks. Koik paringud tehakse HTTPS kaudu, et tagada vahetavate andmete konfidentsiaalsus. Vastused ning POST- ja PUT-paringute kehad on susteemseelt JSON-vormingus. URL-i struktuur on ressursile orienteeritud, voimaldades teil intuitiivselt suhelda meie susteemi erinevate objektidega, nagu kontod, tehingud voi eelarved. Rakendame paringupiirangute susteemi, et tagada platvormi stabiilsus koigile kasutajatele. Nende piirangute uksikasjad on maaratud iga vastuse paisevormmingus.
Peamised lopp-punktid ja kasutusjuhtumid
Meie API pakub mitut lopp-punkti koigi finantsjuhtimise funktsioonide katmiseks. Lopp-punkt `/transactions` voimaldab teil loetleda, filtreerida ja tuua iga tehingu uksikasjad, ideaalne pohjalike kuluanaluuside jaoks. Lopp-punktiga `/accounts` saate oma uhendatud kontode loendi ja nende reaalajas saldod. Eelarve jalgimiseks annavad lopp-punktid `/budgets` ja `/categories` teile taiuliku kontrolli kulukatte loomise ja jalgimise ule. Lopuks voimaldab lopp-punkt `/goals` hallata teie saastueesmarke. Need kombineeritud toristad avavad ukse paljudele rakendustele, lihtsast andmeekspordiskriptist kuni taiusliku mobiilse finantsnooustamise rakenduseni.
API autentimine ja turvalisus
Turvalisus on meie absoluutne prioriteet. API juurdepaans on kaitstud isiklike autentimisvotmetega, mida saate genereerida, hallata ja tuhistada oma kasutaja juhtpaneelilt. Iga API paring peab sisaldama teie API-votit `Authorization` paises Bearer Tokenina. On kohustuslik hoida need votmed saladuses ja mitte kunagi neid kliendi poolel paljastada (naiteks brauseri JavaScripti koodis). Koik API-uhendused on kruuptitud TLS-iga (SSL). Soovitame kasutada ka veebihookusid, et saada reaalajas teatisi olulistest sundmustest, nagu uus tehing, selle asemel et API-t pidevalt kuusitleda, vahendades seelaugu paringute mahtu ja optimeerides joudlust.