API Finance.HDdev
Integrujte Finance.HDdev do svojich nastrojov. Pristupte k svojim uctom, transakciam, rozpoctom a kategoriam cez jednoduche a bezpecne REST API.
Autentifikacia
Bearer token (JWT). Ziskajte svoj token z osobneho dashboardu v nastaveniach uctu.
Zakladna URL
Vsetky poziadavky pouzivaju nasledujucu zakladnu URL:
https://finance.hddev.eu/api/v1Format
Vsetky poziadavky a odpovede pouzivaju format JSON. Pozadovana hlavicka: Content-Type: application/json
Priklad autentifikacie
curl -X GET https://finance.hddev.eu/api/v1/accounts \ -H "Authorization: Bearer VOTRE_TOKEN_JWT" \ -H "Content-Type: application/json"
Dostupne endpointy
Prehlad hlavnych endpointov API Finance.HDdev.
/api/v1/accountsZoznam pripojenych bankovych uctov so zostatkami a metadatami.
/api/v1/transactionsZoznam transakcii s filtrami (datum, kategoria, suma, ucet).
/api/v1/budgetsRozpocty a ciele s aktualnym pokrokom.
/api/v1/transactionsVytvorenie manualnej transakcie (vydavok, prijem alebo prevod).
/api/v1/categoriesDostupne kategorie (systemove a vlastne).
Limity poziadaviek
Poziadavky API su limitovane na zabezpecenie stability sluzby.
Uplna dokumentacia
Uplna interaktivna dokumentacia (OpenAPI / Swagger) bude coskoro k dispozicii. Bude obsahovat schemy poziadaviek a odpovedi, chybove kody a podrobne priklady.
Bezpecnost
Vsetka komunikacia je sifrovana cez HTTPS/TLS. JWT tokeny vyprsia po 30 minutach (automaticka obnova cez refresh token). API je v sulade s GDPR a nikdy nevracia bankove poverenia.
Potrebujete pomoc s API?
Nas technicky tym je k dispozicii, aby vam pomohol s integraciou Finance.HDdev API do vasich nastrojov a pracovnych postupov.
Kontaktovat API tymapi@hddev.eu
Principy architektury a pouzitia
Finance.HDdev API je zalozene na RESTful architekture, co ho robi predvidatelnym a jednoduchym na pouzitie. Vsetky poziadavky su realizovane cez HTTPS na zabezpecenie dovorednosti vymenanych dat. Odpovede, ako aj tela poziadaviek POST a PUT, su systematicky formatovane v JSON. Struktura URL je orientovana na zdroje, co vam umoznuje intuitivne interagovat s roznymi objektmi v nasom systeme, ako su ucty, transakcie alebo rozpocty. Aplikujeme system obmedzovania rychlosti na zabezpecenie stability platformy pre vsetkych nasich pouzivatelov. Podrobnosti o tychto limitoch su specifikovane v kazdej hlavicke odpovede.
Klucove endpointy a pripady pouzitia
Nase API vystavuje viacero endpointov na pokrytie vsetkych funkcii spravy financii. Endpoint `/transactions` vam umoznuje vypisat, filtrovat a ziskat podrobnosti kazdej transakcie, idealny na hlbkovu analyzu vydavkov. S `/accounts` mozete ziskat zoznam vasich pripojenych uctov a ich zostatky v realnom case. Pre sledovanie rozpoctu vam endpointy `/budgets` a `/categories` daju plnu kontrolu nad vytvaranim a sledovanim vasich obalokov na vydavky. Napokon, endpoint `/goals` vam umozni spravovat vase sporiace ciele. Tieto kombinovane nastroje otvaraju dvere k mnohym aplikaciam, od jednoducheho skriptu na export dat az po kompletnu mobilnu aplikaciu na financny coaching.
Autentifikacia a bezpecnost API
Bezpecnost je nasou absolutnou prioritou. Pristup k API je chraneny osobnymi autentifikacnymi klucmi, ktore mozete generovat, spravovat a odvolat z vasho dashboardu. Kazda poziadavka API musi obsahovat vas API kluc v hlavicke `Authorization` ako Bearer Token. Je nevyhnutne udrzovat tieto kluce v tajnosti a nikdy ich nevystavovat na strane klienta (v prehliadacovom JavaScripte, napriklad). Vsetky API pripojenia su sifrovane pomocou TLS (SSL). Odporucame vam tiez pouzivat webhooky na prijem notifikacii v realnom case o dolezitych udalostiach, ako je nova transakcia, namiesto neustaleho dotazovania API, cim sa znizi objem poziadaviek a optimalizuje vykon.