API Finance.HDdev

Integrieren Sie Finance.HDdev in Ihre Tools. Greifen Sie über eine einfache und sichere REST-API auf Ihre Konten, Transaktionen, Budgets und Kategorien zu.

Authentifizierung

Bearer Token (JWT). Erhalten Sie Ihren Token in Ihrem persönlichen Bereich in den Kontoeinstellungen.

Basis-URL

Alle Anfragen verwenden die folgende Basis-URL:

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

Format

Alle Anfragen und Antworten verwenden das JSON-Format. Erforderlicher Header: Content-Type: application/json

Authentifizierungsbeispiel

cURL

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

Verfügbare Endpoints

Übersicht der wichtigsten Endpoints der Finance.HDdev-API.

GET/api/v1/accounts

Liste der verbundenen Bankkonten mit Salden und Metadaten.

GET/api/v1/transactions

Liste der Transaktionen mit Filtern (Datum, Kategorie, Betrag, Konto).

GET/api/v1/budgets

Budgets und Ziele mit aktuellem Fortschritt.

POST/api/v1/transactions

Manuelle Transaktion erstellen (Ausgabe, Einnahme oder Überweisung).

GET/api/v1/categories

Verfügbare Kategorien (System und benutzerdefiniert).

Rate Limits

API-Anfragen sind begrenzt, um die Stabilität des Dienstes zu gewährleisten.

Alle Pläne100 req/minute

Authentifizierung5 req/15 min

Vollständige Dokumentation

Die vollständige interaktive Dokumentation (OpenAPI / Swagger) wird in Kürze verfügbar sein. Sie wird Anfrage- und Antwortschemata, Fehlercodes und detaillierte Beispiele enthalten.

Sicherheit

Alle Kommunikationen werden über HTTPS/TLS verschlüsselt. JWT-Tokens laufen nach 30 Minuten ab (automatische Erneuerung über Refresh-Token). Die API ist DSGVO-konform und gibt niemals Bankzugangsdaten zurück.

Brauchen Sie Hilfe mit der API?

Unser technisches Team steht Ihnen zur Verfügung, um Sie bei der Integration der Finance.HDdev-API in Ihre Tools und Workflows zu unterstützen.

API-Team kontaktieren

api@hddev.eu

Architekturprinzipien und Nutzung

Die Finance.HDdev-API basiert auf einer RESTful-Architektur, die sie vorhersagbar und einfach zu nutzen macht. Alle Anfragen werden über HTTPS durchgeführt, um die Vertraulichkeit der ausgetauschten Daten zu gewährleisten. Antworten sowie die Body von POST- und PUT-Anfragen werden systematisch im JSON-Format formatiert. Die URL-Struktur ist ressourcenorientiert und ermöglicht Ihnen eine intuitive Interaktion mit den verschiedenen Objekten unseres Systems, wie Konten, Transaktionen oder Budgets. Wir wenden ein Rate-Limiting-System an, um die Stabilität der Plattform für alle unsere Nutzer sicherzustellen. Die Details dieser Grenzen werden im Header jeder Antwort angegeben.

Schlüssel-Endpoints und Anwendungsfälle

Unsere API stellt mehrere Endpoints bereit, um alle Funktionen der Finanzverwaltung abzudecken. Der Endpoint `/transactions` ermöglicht es Ihnen, die Details jeder Transaktion aufzulisten, zu filtern und abzurufen, ideal für tiefgehende Ausgabenanalysen. Mit `/accounts` können Sie die Liste Ihrer verbundenen Konten und deren Echtzeitsaldo abrufen. Für die Budgetverfolgung geben Ihnen die Endpoints `/budgets` und `/categories` volle Kontrolle über die Erstellung und Verfolgung Ihrer Ausgabenbudgets. Schließlich ermöglicht der Endpoint `/goals` die Verwaltung Ihrer Sparziele. Diese kombinierten Tools eröffnen zahlreiche Anwendungsmöglichkeiten, vom einfachen Datenexportskript bis zur vollständigen mobilen Financial-Coaching-App.

API-Authentifizierung und -Sicherheit

Sicherheit ist unsere oberste Priorität. Der Zugang zur API wird durch persönliche Authentifizierungsschlüssel geschützt, die Sie in Ihrem Benutzer-Dashboard generieren, verwalten und widerrufen können. Jede API-Anfrage muss Ihren API-Schlüssel im `Authorization`-Header als Bearer Token enthalten. Es ist unerlässlich, diese Schlüssel geheim zu halten und sie niemals clientseitig offenzulegen (z.B. in Browser-JavaScript-Code). Alle Verbindungen zur API werden mit TLS (SSL) verschlüsselt. Wir ermutigen Sie auch, Webhooks zu nutzen, um Echtzeitbenachrichtigungen über wichtige Ereignisse wie eine neue Transaktion zu erhalten, anstatt die API ständig abzufragen, was das Anfragevolumen reduziert und die Leistung optimiert.