API Finance.HDdev
Integreer Finance.HDdev in uw tools. Krijg toegang tot uw rekeningen, transacties, budgetten en categorieën via een eenvoudige en beveiligde REST API.
Authenticatie
Bearer token (JWT). Verkrijg uw token vanuit uw persoonlijke ruimte in de accountinstellingen.
Basis-URL
Alle verzoeken gebruiken de volgende basis-URL:
https://finance.hddev.eu/api/v1Formaat
Alle verzoeken en antwoorden gebruiken het JSON-formaat. Vereiste header: Content-Type: application/json
Authenticatievoorbeeld
curl -X GET https://finance.hddev.eu/api/v1/accounts \ -H "Authorization: Bearer VOTRE_TOKEN_JWT" \ -H "Content-Type: application/json"
Beschikbare endpoints
Overzicht van de belangrijkste Finance.HDdev API-endpoints.
/api/v1/accountsLijst van verbonden bankrekeningen met saldi en metadata.
/api/v1/transactionsLijst van transacties met filters (datum, categorie, bedrag, rekening).
/api/v1/budgetsBudgetten en doelen met huidige voortgang.
/api/v1/transactionsEen handmatige transactie aanmaken (uitgave, inkomen of overschrijving).
/api/v1/categoriesBeschikbare categorieën (systeem en aangepast).
Snelheidslimieten
API-verzoeken zijn gelimiteerd om de stabiliteit van de dienst te garanderen.
Volledige documentatie
De volledige interactieve documentatie (OpenAPI / Swagger) zal binnenkort beschikbaar zijn. Deze bevat verzoek- en antwoordschema's, foutcodes en gedetailleerde voorbeelden.
Beveiliging
Alle communicatie is versleuteld via HTTPS/TLS. JWT-tokens verlopen na 30 minuten (automatische vernieuwing via refresh token). De API is AVG-conform en retourneert nooit bankinloggegevens.
Hulp nodig met de API?
Ons technisch team staat klaar om u te begeleiden bij de integratie van de Finance.HDdev API in uw tools en workflows.
Contact opnemen met het API-teamapi@hddev.eu
Architectuurprincipes en Gebruik
De Finance.HDdev API is gebaseerd op een RESTful architectuur, waardoor deze voorspelbaar en eenvoudig te gebruiken is. Alle verzoeken worden via HTTPS gedaan om de vertrouwelijkheid van uitgewisselde gegevens te garanderen. Antwoorden, evenals de body van POST- en PUT-verzoeken, zijn systematisch geformateerd in JSON. De URL-structuur is resource-gericht, waardoor u intuïtief kunt communiceren met de verschillende objecten in ons systeem, zoals rekeningen, transacties of budgetten. Wij passen een systeem van snelheidsbeperking (rate limiting) toe om de stabiliteit van het platform voor al onze gebruikers te garanderen. Details van deze limieten staan in de header van elk antwoord.
Belangrijkste Endpoints en Toepassingen
Onze API biedt verschillende endpoints om alle functies van financiël beheer te dekken. Het endpoint `/transactions` stelt u in staat om elke transactie te bekijken, filteren en de details op te vragen, ideaal voor diepgaande uitgavenanalyses. Met `/accounts` kunt u de lijst van uw verbonden rekeningen en hun realtime saldo opvragen. Voor budgetopvolging geven de endpoints `/budgets` en `/categories` u volledige controle over het aanmaken en opvolgen van uw uitgavenenveloppen. Tot slot kunt u met het endpoint `/goals` uw spaardoelen beheren. Deze gecombineerde tools openen de deur naar talrijke toepassingen, van een eenvoudig data-exportscript tot een volledige mobiele financiële coaching-app.
API-Authenticatie en Beveiliging
Beveiliging is onze absolute prioriteit. De toegang tot de API wordt beschermd door persoonlijke authenticatiesleutels die u kunt genereren, beheren en intrekken vanuit uw gebruikersdashboard. Elk API-verzoek moet uw API-sleutel bevatten in de `Authorization`-header als Bearer Token. Het is noodzakelijk deze sleutels geheim te houden en nooit aan de clientzijde bloot te stellen (in browser JavaScript-code, bijvoorbeeld). Alle API-verbindingen zijn versleuteld met TLS (SSL). Wij moedigen u ook aan webhooks te gebruiken om realtime meldingen te ontvangen over belangrijke gebeurtenissen, zoals een nieuwe transactie, in plaats van de API continu te bevragen, waardoor het verzoekvolume wordt verminderd en de prestaties worden geoptimaliseerd.