API Finance.HDdev

Integrera Finance.HDdev i dina verktyg. Fa tillgang till dina konton, transaktioner, budgetar och kategorier via ett enkelt och sakert REST API.

Autentisering

Bearer-token (JWT). Hamta din token fran din personliga instrumentpanel i kontoinstaallningarna.

Bas-URL

Alla forfragnigner anvander foljande bas-URL:

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

Format

Alla forfragninger och svar anvander JSON-format. Obligatorisk header: Content-Type: application/json

Autentiseringsexempel

cURL

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

Tillgangliga andpunkter

Oversikt over de viktigaste API-andpunkterna for Finance.HDdev.

GET/api/v1/accounts

Lista over anslutna bankkonton med saldon och metadata.

GET/api/v1/transactions

Lista over transaktioner med filter (datum, kategori, belopp, konto).

GET/api/v1/budgets

Budgetar och mal med aktuell framgang.

POST/api/v1/transactions

Skapa en manuell transaktion (utgift, inkomst eller overforing).

GET/api/v1/categories

Tillgangliga kategorier (system och egna).

Begransning av forfragninger

API-forfragningar ar begransade for att sakerstalla tjanstens stabilitet.

Alla planer100 req/minute

Autentisering5 req/15 min

Fullstandig dokumentation

Den fullstandiga interaktiva dokumentationen (OpenAPI / Swagger) kommer snart att finnas tillganglig. Den kommer att inkludera schemas for forfragningar och svar, felkoder och detaljerade exempel.

Sakerhet

All kommunikation ar krypterad via HTTPS/TLS. JWT-token gar ut efter 30 minuter (automatisk fornyelse via refresh-token). API:et ar GDPR-kompatibelt och returnerar aldrig bankinloggningsuppgifter.

Behover du hjalp med API:et?

Vart tekniska team ar tillgangligt for att hjalpa dig integrera Finance.HDdev API i dina verktyg och arbetsfloden.

Kontakta API-teamet

api@hddev.eu

Arkitekturprinciper och anvandning

Finance.HDdev API ar baserat pa en RESTful-arkitektur, vilket gor det forutsagbart och enkelt att anvanda. Alla forfragningar gors via HTTPS for att sakerstalla sekretessen for utbytta data. Svar, liksom POST- och PUT-forfragnigskroppar, ar systematiskt formaterade i JSON. URL-strukturen ar resursorienterad, vilket gor att du intuitivt kan interagera med de olika objekten i vart system, som konton, transaktioner eller budgetar. Vi tillampar ett hastighetsbegransningssystem for att sakerstalla plattformens stabilitet for alla vara anvandare. Detaljer om dessa begransningar anges i varje svarsheader.

Viktiga andpunkter och anvandningsfall

Vart API exponerar flera andpunkter for att tacka alla ekonomihanteringsfunktioner. Andpunkten `/transactions` later dig lista, filtrera och hamta detaljer for varje transaktion, idealisk for djupgaende utgiftsanalys. Med `/accounts` kan du hamta listan over dina anslutna konton och deras saldon i realtid. For budgetsparning ger andpunkterna `/budgets` och `/categories` dig full kontroll over att skapa och follja upp dina utgiftskuvert. Slutligen later andpunkten `/goals` dig hantera dina sparmal. Dessa kombinerade verktyg oppnar dorren till manga applikationer, fran ett enkelt dataexportskript till en komplett mobilapp for ekonomisk coachning.

API-autentisering och sakerhet

Sakerhet ar var absoluta prioritet. API-atkomst skyddas av personliga autentiseringsnycklar som du kan generera, hantera och aterkalla fran din instrumentpanel. Varje API-forfragning maste inkludera din API-nyckel i `Authorization`-headern som en Bearer Token. Det ar absolut nodvandigt att halla dessa nycklar hemliga och aldrig exponera dem pa klientsidan (i webblasarens JavaScript-kod, till exempel). Alla API-anslutningar ar krypterade med TLS (SSL). Vi upppmuntrar dig ocksa att anvanda webhooks for att ta emot realtidsmeddelanden om viktiga handelser, som en ny transaktion, istallet for att kontinuerligt polla API:et, vilket minskar forfragnigsolymen och optimerar prestandan.