API Finance.HDdev

Integrirajte Finance.HDdev u svoje alate. Pristupite računima, transakcijama, budžetima i kategorijama putem jednostavnog i sigurnog REST API-ja.

Autentifikacija

Bearer token (JWT). Pribavite token iz osobne nadzorne ploče u postavkama računa.

Osnovni URL

Svi zahtjevi koriste sljedeći osnovni URL:

https://finance.hddev.eu/api/v1

Format

Svi zahtjevi i odgovori koriste JSON format. Obvezno zaglavlje: Content-Type: application/json

Primjer autentifikacije

cURL

curl -X GET https://finance.hddev.eu/api/v1/accounts \
  -H "Authorization: Bearer VOTRE_TOKEN_JWT" \
  -H "Content-Type: application/json"

Dostupne krajnje točke

Pregled glavnih krajnjih točaka Finance.HDdev API-ja.

GET/api/v1/accounts

Popis povezanih bankovnih računa sa stanjima i metapodacima.

GET/api/v1/transactions

Popis transakcija s filterima (datum, kategorija, iznos, račun).

GET/api/v1/budgets

Budžeti i ciljevi s trenutnim napretkom.

POST/api/v1/transactions

Kreiranje ručne transakcije (rashod, prihod ili prijenos).

GET/api/v1/categories

Dostupne kategorije (sistemske i prilagođene).

Ograničenja brzine

API zahtjevi su ograničeni brzinom radi osiguranja stabilnosti usluge.

Svi planovi100 req/minute

Autentifikacija5 req/15 min

Potpuna dokumentacija

Potpuna interaktivna dokumentacija (OpenAPI / Swagger) uskoro će biti dostupna. Uključivat će sheme zahtjeva i odgovora, kodove grešaka i detaljne primjere.

Sigurnost

Sve komunikacije šifrirane su putem HTTPS/TLS. JWT tokeni istječu nakon 30 minuta (automatska obnova putem refresh tokena). API je usklađen s GDPR-om i nikada ne vraća bankovne vjerodajnice.

Trebate pomoć s API-jem?

Naš tehnički tim dostupan je za pomoć pri integraciji Finance.HDdev API-ja u vaše alate i radne tijekove.

Kontaktirajte API tim

api@hddev.eu

Načela arhitekture i korištenje

Finance.HDdev API temelji se na RESTful arhitekturi, što ga čini predvidivim i jednostavnim za korištenje. Svi zahtjevi šalju se putem HTTPS-a radi osiguranja povjerljivosti razmijenjenih podataka. Odgovori, kao i tijela POST i PUT zahtjeva, sustavno su formatirani u JSON-u. Struktura URL-ova orijentirana je na resurse, omogućujući intuitivnu interakciju s različitim objektima našeg sustava, poput računa, transakcija ili budžeta. Primjenjujemo sustav ograničenja brzine za osiguranje stabilnosti platforme za sve korisnike. Pojedinosti ovih ograničenja navedene su u zaglavlju svakog odgovora.

Ključne krajnje točke i primjeri korištenja

Naš API izlaže nekoliko krajnjih točaka za pokrivanje svih značajki upravljanja financijama. Krajnja točka `/transactions` omogućuje popisivanje, filtriranje i dohvaćanje detalja svake transakcije, idealno za dubinske analize troškova. S `/accounts` možete dobiti popis povezanih računa i njihova stanja u stvarnom vremenu. Za praćenje budžeta, krajnje točke `/budgets` i `/categories` daju potpunu kontrolu nad kreiranjem i praćenjem omotnica za troškove. Konačno, krajnja točka `/goals` omogućuje upravljanje ciljevima štednje. Ovi kombinirani alati otvaraju vrata brojnim primjenama, od jednostavne skripte za izvoz podataka do potpune mobilne aplikacije za financijski coaching.

API autentifikacija i sigurnost

Sigurnost je naš apsolutni prioritet. Pristup API-ju zaštićen je osobnim ključevima za autentifikaciju koje možete generirati, upravljati i opozvati sa svoje korisničke nadzorne ploče. Svaki API zahtjev mora sadržavati vaš API ključ u zaglavlju `Authorization` kao Bearer Token. Imperativno je čuvati ove ključeve tajnima i nikada ih ne izlagati na klijentskoj strani (u JavaScript kodu preglednika, na primjer). Sve API veze šifrirane su TLS-om (SSL). Također vas potičemo na korištenje webhookova za primanje obavijesti u stvarnom vremenu o važnim događajima, poput nove transakcije, umjesto neprekidnog prozivanja API-ja, čime se smanjuje obujam zahtjeva i optimiziraju performanse.