API Finance.HDdev
Integrer Finance.HDdev i dine værktøjer. Få adgang til dine konti, transaktioner, budgetter og kategorier via en enkel og sikker REST API.
Godkendelse
Bearer token (JWT). Hent dit token fra dit personlige område i kontoindstillingerne.
Basis-URL
Alle forespørgsler bruger følgende basis-URL:
https://finance.hddev.eu/api/v1Format
Alle forespørgsler og svar bruger JSON-formatet. Påkrævet header: Content-Type: application/json
Godkendelseseksempel
curl -X GET https://finance.hddev.eu/api/v1/accounts \ -H "Authorization: Bearer VOTRE_TOKEN_JWT" \ -H "Content-Type: application/json"
Tilgængelige endpoints
Oversigt over de vigtigste Finance.HDdev API-endpoints.
/api/v1/accountsListe over forbundne bankkonti med saldi og metadata.
/api/v1/transactionsListe over transaktioner med filtre (dato, kategori, beløb, konto).
/api/v1/budgetsBudgetter og mål med aktuel fremgang.
/api/v1/transactionsOpret en manuel transaktion (udgift, indtægt eller overførsel).
/api/v1/categoriesTilgængelige kategorier (system og brugerdefinerede).
Hastighedsgrænser
API-forespørgsler er begrænset for at sikre tjenestens stabilitet.
Fuld dokumentation
Den fulde interaktive dokumentation (OpenAPI / Swagger) vil snart være tilgængelig. Den vil inkludere forespørgsels- og svarskemaer, fejlkoder og detaljerede eksempler.
Sikkerhed
Al kommunikation er krypteret via HTTPS/TLS. JWT-tokens udløber efter 30 minutter (automatisk fornyelse via refresh token). API'en er GDPR-kompatibel og returnerer aldrig bankoplysninger.
Brug for hjælp med API'en?
Vores tekniske team er klar til at hjælpe dig med at integrere Finance.HDdev API i dine værktøjer og workflows.
Kontakt API-teametapi@hddev.eu
Arkitekturprincipper og Brug
Finance.HDdev API er baseret på en RESTful arkitektur, hvilket gør den forudsigelig og nem at bruge. Alle forespørgsler foretages via HTTPS for at sikre fortroligheden af udvekslede data. Svar samt POST- og PUT-forespørgslers body er systematisk formateret i JSON. URL-strukturen er ressourceorienteret, så du intuitivt kan interagere med de forskellige objekter i vores system, som konti, transaktioner eller budgetter. Vi anvender et hastighedsbegrænsningssystem for at sikre platformens stabilitet for alle vores brugere. Detaljer om disse grænser er angivet i hver svars header.
Vigtige Endpoints og Anvendelsestilfælde
Vores API eksponerer flere endpoints for at dække alle funktioner inden for økonomistyring. Endpoint `/transactions` giver dig mulighed for at liste, filtrere og hente detaljer om hver transaktion, ideel til dybdegående udgiftsanalyser. Med `/accounts` kan du få listen over dine forbundne konti og deres realtidssaldo. Til budgetsporing giver endpoints `/budgets` og `/categories` dig fuld kontrol over oprettelse og overvågning af dine udgiftskuverter. Endelig lader endpoint `/goals` dig administrere dine opsparingsmål. Disse kombinerede værktøjer åbner døren til mange applikationer, fra et simpelt dataeksportscript til en komplet mobil finansiel coaching-app.
API-Godkendelse og Sikkerhed
Sikkerhed er vores absolutte prioritet. Adgangen til API'en er beskyttet af personlige godkendelsesnøgler, som du kan generere, administrere og tilbagekalde fra dit brugerdashboard. Hver API-forespørgsel skal indeholde din API-nøgle i `Authorization`-headeren som Bearer Token. Det er afgørende at holde disse nøgler hemmelige og aldrig eksponere dem på klientsiden (i browser JavaScript-kode, for eksempel). Alle API-forbindelser er krypteret med TLS (SSL). Vi opfordrer dig også til at bruge webhooks til at modtage realtidsnotifikationer om vigtige hændelser, som en ny transaktion, i stedet for løbende at forespørge API'en, hvilket reducerer forespørgselsvolumen og optimerer ydeevnen.