API Finance.HDdev
Integroi Finance.HDdev työkaluihisi. Käytä tilejäsi, tapahtumia, budjetteja ja kategorioita yksinkertaisen ja turvallisen REST API:n kautta.
Tunnistautuminen
Bearer token (JWT). Hae tokenisi henkilökohtaisesta tilastasi tiliasetuksissa.
Perus-URL
Kaikki pyynnöt käyttävät seuraavaa perus-URL:ää:
https://finance.hddev.eu/api/v1Muoto
Kaikki pyynnöt ja vastaukset käyttävät JSON-muotoa. Vaadittu otsikko: Content-Type: application/json
Tunnistautumisesimerkki
curl -X GET https://finance.hddev.eu/api/v1/accounts \ -H "Authorization: Bearer VOTRE_TOKEN_JWT" \ -H "Content-Type: application/json"
Saatavilla olevat endpoints
Yleiskatsaus Finance.HDdev API:n tärkeimpiin endpointeihin.
/api/v1/accountsYhdistettyjen pankkitilien luettelo saldoineen ja metatietoineen.
/api/v1/transactionsTapahtumien luettelo suodattimilla (päivämäärä, kategoria, summa, tili).
/api/v1/budgetsBudjetit ja tavoitteet nykyisellä edistymisellä.
/api/v1/transactionsLuo manuaalinen tapahtuma (meno, tulo tai siirto).
/api/v1/categoriesSaatavilla olevat kategoriat (järjestelmä- ja mukautetut).
Pyyntörajat
API-pyynnöt on rajattu palvelun vakauden varmistamiseksi.
Täysi dokumentaatio
Täysi interaktiivinen dokumentaatio (OpenAPI / Swagger) tulee pian saataville. Se sisältää pyyntö- ja vastausskeemoja, virhekoodeja ja yksityiskohtaisia esimerkkejä.
Turvallisuus
Kaikki viestintä on salattu HTTPS/TLS:llä. JWT-tokenit vanhenevat 30 minuutin jälkeen (automaattinen uusinta refresh tokenilla). API on GDPR-yhteensopiva eikä koskaan palauta pankkitunnuksia.
Tarvitsetko apua API:n kanssa?
Tekninen tiimimme on käytettävissä auttamaan Finance.HDdev API:n integroinnissa työkaluihisi ja työnkulkuihisi.
Ota yhteyttä API-tiimiinapi@hddev.eu
Arkkitehtuuriperiaatteet ja käyttö
Finance.HDdev API perustuu RESTful-arkkitehtuuriin, mikä tekee siitä ennustettavan ja helppokäyttöisen. Kaikki pyynnöt tehdään HTTPS:n kautta vaihdettujen tietojen luottamuksellisuuden varmistamiseksi. Vastaukset sekä POST- ja PUT-pyyntöjen rungot muotoillaan järjestelmällisesti JSON-muodossa. URL-rakenne on resurssikeskeinen, mikä mahdollistaa intuitiivisen vuorovaikutuksen järjestelmämme eri objektien, kuten tilien, tapahtumien tai budjettien kanssa. Käytämme pyyntörajoitusjärjestelmää alustan vakauden varmistamiseksi kaikille käyttäjillemme. Näiden rajoitusten yksityiskohdat on määritelty kunkin vastauksen otsikossa.
Tärkeimmät endpointit ja käyttötapaukset
API:mme tarjoaa useita endpointeja kattamaan kaikki taloushallinnon ominaisuudet. `/transactions`-endpoint mahdollistaa tapahtumien listaamisen, suodattamisen ja yksityiskohtien hakemisen, ihanteellinen syvälliseen kulutusanalyysiin. `/accounts`-endpointilla saat luettelon yhdistetyistä tileistäsi ja niiden reaaliaikaiset saldot. Budjettiseurantaan `/budgets`- ja `/categories`-endpointit antavat täyden hallinnan kulukirjekuoriesi luomiseen ja seurantaan. Lopuksi `/goals`-endpoint mahdollistaa säästötavoitteidesi hallinnan. Nämä yhdistetyt työkalut avaavat oven monille sovelluksille yksinkertaisesta tietojenvientiskriptistä täydelliseen mobiilitalousvalmennussovellukseen.
API:n tunnistautuminen ja turvallisuus
Turvallisuus on ehdoton prioriteettimme. API-pääsy on suojattu henkilökohtaisilla tunnistautumisavaimilla, jotka voit luoda, hallita ja kumota käyttäjän koontinäytöstäsi. Jokaisen API-pyynnön tulee sisältää API-avaimesi `Authorization`-otsikossa Bearer Tokenina. On välttämätöntä pitää nämä avaimet salaisina eikä koskaan paljastaa niitä asiakaspuolella (selainten JavaScript-koodissa esimerkiksi). Kaikki API-yhteydet on salattu TLS:llä (SSL). Kannustamme myös käyttämään webhookeja reaaliaikaisten ilmoitusten vastaanottamiseen tärkeistä tapahtumista, kuten uudesta tapahtumasta, sen sijaan että kyselisit API:a jatkuvasti, vähentäen siten pyyntömääriä ja optimoiden suorituskykyä.