Ein Slim Laravel REST-Client für HBCI FinTS Bankverbindungen mit authentifiziertem API-Zugang.

• ✅ HBCI FinTS Integration mit nemiah/php-fints
• ✅ Authentifizierter REST-Endpunkt für Kontostand-Abfrage
• ✅ Docker-basierte Entwicklungsumgebung
• ✅ Keine Datenbank erforderlich
• ✅ Konfiguration über Umgebungsvariablen

• Docker und Docker Compose
• HBCI FinTS Zugangsdaten Ihrer Bank

1. Repository klonen und in das Verzeichnis wechseln:

   cd hbci-rest-client

2. Umgebungsvariablen konfigurieren:

   cp env.example .env

   Bearbeiten Sie die .env Datei mit Ihren FinTS-Zugangsdaten:

   # HBCI FinTS Configuration
   FINTS_BANK_URL=https://fints.ihre-bank.de/fints
   FINTS_BANK_CODE=12345678
   FINTS_USERNAME=ihr-username
   FINTS_PIN=ihr-pin
   # API Authentication
   API_PASSWORD=ihr-sicheres-api-passwort

3. Docker Container starten:

   docker-compose up --build

4. Anwendung testen:

   curl -H "Authorization: Bearer ihr-sicheres-api-passwort" http://localhost:8000/api/balance

Ruft den aktuellen Kontostand über HBCI FinTS ab.

Headers:

• Authorization: Bearer {API_PASSWORD}

Beispiel-Request:

curl -H "Authorization: Bearer mein-api-passwort" \
 http://localhost:8000/api/balance

Beispiel-Response:

{
 "success": true,
 "balance": 1234.56,
 "currency": "EUR",
 "timestamp": "2024年01月15日T10:30:00+01:00"
}

Fehler-Response:

{
 "error": "Failed to retrieve balance: Connection timeout"
}

# Container im Hintergrund starten
docker-compose up -d
# Logs anzeigen
docker-compose logs -f
# Container stoppen
docker-compose down

hbci-rest-client/
├── public/
│ └── index.php # Anwendungseinstiegspunkt
├── src/
│ ├── Controllers/
│ │ └── AccountController.php # FinTS Controller
│ └── Middleware/
│ └── AuthMiddleware.php # API-Authentifizierung
├── docker-compose.yml # Docker-Konfiguration
├── Dockerfile # PHP-Container
├── composer.json # PHP-Abhängigkeiten
└── .env # Umgebungsvariablen

• ⚠️ Nie FinTS-Zugangsdaten in den Code einbetten
• ⚠️ Nie die .env Datei committen
• ⚠️ Verwenden Sie ein sicheres API-Passwort
• ⚠️ Beschränken Sie den API-Zugang auf vertrauenswürdige IPs

1. FinTS-Verbindung schlägt fehl:

   • Überprüfen Sie die Bank-URL und Zugangsdaten
   • Stellen Sie sicher, dass FinTS für Ihr Konto aktiviert ist

2. API-Authentifizierung schlägt fehl:

   • Überprüfen Sie das API-Passwort in der .env Datei
   • Stellen Sie sicher, dass der Authorization-Header korrekt gesetzt ist

3. Docker-Container startet nicht:

   • Überprüfen Sie, ob Port 8000 verfügbar ist
   • Führen Sie docker-compose down und dann docker-compose up --build aus

MIT License