📚 VermieterBox API Dokumentation

Version 2.0.0 | REST API

🔐 Authentifizierung

POST /api/auth/login
Anmeldung mit E-Mail und Passwort
{
  "email": "admin@vermieterbox.lan",
  "password": "admin123"
}
POST /api/auth/logout 🔒 Auth Required
Abmelden und Token invalidieren
GET /api/auth/verify 🔒 Auth Required
Token verifizieren und User-Info abrufen

🏢 Objekte

GET /api/objekte 🔒 Auth Required
Liste aller Objekte abrufen
GET /api/objekte/:id 🔒 Auth Required
Einzelnes Objekt abrufen
POST /api/objekte 🔒 Auth Required
Neues Objekt erstellen
PUT /api/objekte/:id 🔒 Auth Required
Objekt aktualisieren
DELETE /api/objekte/:id 🔒 Auth Required
Objekt löschen

🏠 Einheiten

GET /api/einheiten 🔒 Auth Required
Liste aller Einheiten
GET /api/einheiten/:id 🔒 Auth Required
Einzelne Einheit abrufen
GET /api/einheiten/:id/bewohner 🔒 Auth Required
Bewohner einer Einheit abrufen
POST /api/einheiten 🔒 Auth Required
Neue Einheit erstellen
PUT /api/einheiten/:id 🔒 Auth Required
Einheit aktualisieren

🧩 Addon System

GET /api/addons 🔒 Auth Required
Liste aller installierten Addons
GET /api/addons/:id 🔒 Auth Required
Addon-Details abrufen
POST /api/addons/:id/enable 🔒 Auth Required
Addon aktivieren
POST /api/addons/:id/disable 🔒 Auth Required
Addon deaktivieren
GET /api/addons/:id/config 🔒 Auth Required
User-spezifische Addon-Konfiguration
POST /api/addons/:id/config 🔒 Auth Required
Addon-Konfiguration speichern
POST /api/addons/install 🔒 Auth Required
Addon aus .vbaddon Datei installieren

⚙️ Settings

GET /api/settings 🔒 Auth Required
User-Settings abrufen
POST /api/settings 🔒 Auth Required
User-Settings speichern
{
  "general": {
    "company": "Meine Hausverwaltung",
    "street": "Musterstr. 1",
    "zip": "12345",
    "city": "Berlin"
  },
  "appearance": {
    "darkmode": true,
    "themeColor": "#667eea"
  }
}

📝 Allgemeine Hinweise

🚀 Quick Start

# 1. Login
curl -X POST /api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@vermieterbox.lan","password":"admin123"}'

# 2. Use Token for API Calls
curl /api/objekte \
  -H "Authorization: Bearer YOUR_TOKEN_HERE"