+ Übersicht über alle verfügbaren API-Endpoints und deren Verwendung +
++ Alle API-Endpoints erfordern Authentifizierung (außer Login). Es werden zwei Methoden unterstützt: +
+Nach dem Login über /api/auth/login wird automatisch ein Cookie gesetzt.
Header: Authorization: Bearer <token>
Der Token wird im Login-Response im Feld token zurückgegeben.
Benutzer einloggen und Token erhalten
+ +Request Body:
+{
+ "email": "benutzer@example.com",
+ "password": "passwort"
+}Response:
+{
+ "success": true,
+ "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+ "user": {
+ "id": "user-id",
+ "email": "benutzer@example.com",
+ "name": "Max Mustermann",
+ "role": "mitglied"
+ }
+}Benutzer ausloggen
+ +Response:
+{
+ "success": true,
+ "message": "Erfolgreich ausgeloggt"
+}Aktuellen Authentifizierungsstatus abrufen
+ +Response:
+{
+ "isLoggedIn": true,
+ "user": {
+ "id": "user-id",
+ "email": "benutzer@example.com",
+ "name": "Max Mustermann",
+ "role": "mitglied"
+ },
+ "role": "mitglied"
+}Alle Mitglieder abrufen (mit Merge aus registrierten Benutzern)
+ +Response:
+{
+ "success": true,
+ "members": [
+ {
+ "id": "member-id",
+ "firstName": "Max",
+ "lastName": "Mustermann",
+ "geburtsdatum": "1990-01-15",
+ "email": "max@example.com",
+ "phone": "0123456789",
+ "address": "Musterstraße 1",
+ "source": "manual",
+ "editable": true,
+ "hasLogin": false
+ }
+ ]
+}Neues Mitglied hinzufügen oder bestehendes bearbeiten
+ +Request Body:
+{
+ "id": "optional-für-update",
+ "firstName": "Max",
+ "lastName": "Mustermann",
+ "geburtsdatum": "1990-01-15",
+ "email": "max@example.com",
+ "phone": "0123456789",
+ "address": "Musterstraße 1, 12345 Musterstadt",
+ "notes": "Optional"
+}Response:
+{
+ "success": true,
+ "message": "Mitglied erfolgreich gespeichert."
+}
+ Hinweis: Ohne id wird ein neues Mitglied erstellt. Mit id wird ein bestehendes Mitglied aktualisiert. geburtsdatum ist Pflichtfeld zur Duplikatsprüfung (Format: YYYY-MM-DD).
+
Mehrere Mitglieder auf einmal importieren (Bulk-Import)
+ +Request Body:
+{
+ "members": [
+ {
+ "firstName": "Max",
+ "lastName": "Mustermann",
+ "geburtsdatum": "1990-01-15",
+ "email": "max@example.com",
+ "phone": "0123456789",
+ "address": "Musterstraße 1",
+ "notes": "Optional"
+ },
+ {
+ "firstName": "Anna",
+ "lastName": "Schmidt",
+ "geburtsdatum": "1985-03-20",
+ "email": "anna@example.com"
+ }
+ ]
+}Response:
+{
+ "success": true,
+ "summary": {
+ "total": 2,
+ "imported": 2,
+ "duplicates": 0,
+ "errors": 0
+ },
+ "results": {
+ "success": [
+ {
+ "index": 1,
+ "member": { ... }
+ }
+ ],
+ "duplicates": [],
+ "errors": []
+ }
+}+ Features: +
+Mitglied löschen
+ +Request Body:
+{
+ "id": "member-id"
+}Response:
+{
+ "success": true,
+ "message": "Mitglied erfolgreich gelöscht."
+}Alle News abrufen (inkl. interner News)
+Neue News erstellen oder bestehende bearbeiten
+ +Request Body:
+{
+ "id": "optional-für-update",
+ "title": "Titel der News",
+ "content": "Inhalt der News",
+ "isPublic": true,
+ "expiresAt": "2025-12-31T23:59:59.000Z",
+ "isHidden": false
+}News löschen
+ +Request Body:
+{
+ "id": "news-id"
+}Alle Termine abrufen (für Verwaltung)
+Neuen Termin erstellen
+ +Request Body:
+{
+ "datum": "2025-12-25",
+ "uhrzeit": "19:00",
+ "titel": "Weihnachtsfeier",
+ "beschreibung": "Gemeinsame Feier",
+ "kategorie": "Veranstaltung"
+}Termin löschen
+ +Query Parameters:
+?datum=2025-12-25&uhrzeit=19:00&titel=Weihnachtsfeier&beschreibung=...&kategorie=...Vereinskonfiguration abrufen
+Vereinskonfiguration aktualisieren
+ +Request Body:
+Komplettes Config-Objekt mit allen Einstellungen
+# Login und Token erhalten
+curl -X POST http://localhost:3100/api/auth/login \
+ -H "Content-Type: application/json" \
+ -d '{"email": "admin@example.com", "password": "passwort"}'
+
+# Mitglied hinzufügen mit Token
+curl -X POST http://localhost:3100/api/members \
+ -H "Authorization: Bearer YOUR_TOKEN_HERE" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "firstName": "Max",
+ "lastName": "Mustermann",
+ "geburtsdatum": "1990-01-15",
+ "email": "max@example.com",
+ "phone": "0123456789"
+ }'
+
+# Bulk-Import von Mitgliedern
+curl -X POST http://localhost:3100/api/members/bulk \
+ -H "Authorization: Bearer YOUR_TOKEN_HERE" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "members": [
+ {
+ "firstName": "Max",
+ "lastName": "Mustermann",
+ "geburtsdatum": "1990-01-15",
+ "email": "max@example.com"
+ },
+ {
+ "firstName": "Anna",
+ "lastName": "Schmidt",
+ "geburtsdatum": "1985-03-20",
+ "email": "anna@example.com"
+ }
+ ]
+ }'// Login
+const loginResponse = await fetch('/api/auth/login', {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({
+ email: 'admin@example.com',
+ password: 'passwort'
+ })
+})
+const { token } = await loginResponse.json()
+
+// Mitglied hinzufügen
+const memberResponse = await fetch('/api/members', {
+ method: 'POST',
+ headers: {
+ 'Authorization': `Bearer ${token}`,
+ 'Content-Type': 'application/json'
+ },
+ body: JSON.stringify({
+ firstName: 'Max',
+ lastName: 'Mustermann',
+ geburtsdatum: '1990-01-15',
+ email: 'max@example.com'
+ })
+})
+
+// Bulk-Import
+const bulkResponse = await fetch('/api/members/bulk', {
+ method: 'POST',
+ headers: {
+ 'Authorization': `Bearer ${token}`,
+ 'Content-Type': 'application/json'
+ },
+ body: JSON.stringify({
+ members: [
+ {
+ firstName: 'Max',
+ lastName: 'Mustermann',
+ geburtsdatum: '1990-01-15',
+ email: 'max@example.com'
+ },
+ {
+ firstName: 'Anna',
+ lastName: 'Schmidt',
+ geburtsdatum: '1985-03-20',
+ email: 'anna@example.com'
+ }
+ ]
+ })
+})
+const result = await bulkResponse.json()
+console.log(`Importiert: ${result.summary.imported}, Duplikate: ${result.summary.duplicates}`)