API-Referenz

Referenz der internen API

Diese Endpunkte bilden die Grundlage der IVGraph-Webanwendung. Sofern nicht anders angegeben, erfordern sie eine JWT-Authentifizierung. Sie sind hier als Referenz dokumentiert — für Integrationen solltest du die V1 LLM API bevorzugen.

Benutzer & Profil

Methode Endpunkt Beschreibung
GET /api/auth/me/ Informationen zum aktuellen Benutzer (id, email, username, is_staff)
GET /api/auth/validate/ Gültigkeit des JWT-Tokens prüfen
POST /api/auth/refresh/ Zugriffstoken erneuern
POST /api/auth/logout/ Refresh-Token auf die Sperrliste setzen
GET /api/user/me/ Details zum Benutzerprofil
PUT /api/user/me/ Benutzerprofil aktualisieren
GET /api/user/profile/ Ansicht des Benutzerprofils

Empfehlungssystem

Methode Endpunkt Beschreibung
GET /api/referral/my-code/ Empfehlungscode des Benutzers abrufen
POST /api/referral/apply/ Empfehlungscode anwenden
GET /api/referral/stats/ Empfehlungsstatistiken

Notion-OAuth

Methode Endpunkt Beschreibung
GET /api/integrations/auth/notion/ Notion-OAuth-Ablauf starten (leitet zu Notion weiter)
GET /api/integrations/auth/notion/callback OAuth-Callback (tauscht Code gegen Tokens)
GET /api/integrations/auth/notion/status Status der OAuth-Verbindung prüfen
POST /api/integrations/auth/logout/ Verbindung zur Notion-Integration trennen
POST /api/integrations/auth/delete-account/ Benutzerkonto und alle Daten löschen

Workspaces verwalten

Methode Endpunkt Beschreibung
GET /api/integrations/workspaces/ Notion-Workspaces des Benutzers auflisten
GET /api/integrations/workspaces/<id>/ Workspace-Details
POST /api/integrations/workspaces/<id>/primary/ Workspace als primären Workspace festlegen

Synchronisierung verwalten

Methode Endpunkt Beschreibung
GET /api/integrations/status/ Status von Integration und Synchronisierung
GET /api/integrations/notion/permissions/ Berechtigungen für die Notion-API prüfen
POST /api/integrations/airbyte/setup/ Airbyte-Verbindung für den Workspace einrichten
GET /api/integrations/airbyte/setup/progress/ Fortschritt der Einrichtung
POST /api/integrations/airbyte/sync/ Inkrementelle Synchronisierung auslösen
POST /api/integrations/airbyte/sync/cancel/ Laufende Synchronisierung abbrechen
GET /api/integrations/airbyte/sync/progress/ Fortschritt der Synchronisierung (regelmäßig abfragen)
POST /api/integrations/airbyte/full-refresh/ Vollständige Datenaktualisierung (synchronisiert alles erneut)

Abrechnung (Stripe)

Methode Endpunkt Beschreibung
GET /api/billing/plans/ Verfügbare Abotarife auflisten
POST /api/billing/create-checkout/ Stripe-Checkout-Sitzung erstellen
POST /api/billing/confirm-checkout/ Abgeschlossenen Checkout bestätigen
GET /api/billing/subscription/ Abodetails des Benutzers abrufen
POST /api/billing/portal/ Link zum Stripe-Kundenportal erstellen

Stilregeln & Graph-Einstellungen

Methode Endpunkt Beschreibung
GET /api/databases/ Datenbanken für die gezielte Anwendung von Regeln auflisten
GET/PUT /api/graph-settings/ Globale Graph-Einstellungen (Farben, Schalter)
GET/POST /api/advanced-rules/ Erweiterte Stilregeln auflisten/erstellen
GET/PUT/DELETE /api/advanced-rules/<id>/ Einzelne Regel verwalten
POST /api/advanced-rules/reorder/ Regeln nach Priorität neu ordnen
GET/POST /api/style-presets/ Stilvorgaben auflisten/erstellen
GET/PUT/DELETE /api/style-presets/<id>/ Einzelne Vorgabe verwalten
POST /api/style-presets/<id>/activate/ Vorgabe als aktiv festlegen
POST /api/style-presets/<id>/duplicate/ Vorgabe duplizieren

Service-Tokens verwalten

Methode Endpunkt Beschreibung
GET /api/tokens/ Service-Tokens des Benutzers auflisten
POST /api/tokens/ Neues Service-Token erstellen
DELETE /api/tokens/<id>/ Token widerrufen (dauerhaft)

Details zum Erstellen von Tokens findest du unter Authentifizierung.

Sonstiges

Methode Endpunkt Authentifizierung Beschreibung
GET /api/connections/ JWT Airbyte-Verbindungen des Benutzers auflisten
GET /api/integrations/ JWT Übersicht der Integrationen
GET /api/activity/ JWT Protokoll der letzten Aktivitäten
GET /api/health/ Keine Systemzustand prüfen
GET /api/health/celery/ Keine Zustand der Celery-Worker
GET /api/stats/public/ Keine Plattformstatistiken (24h-Cache)
POST /api/errors/report/ Keine Frontend-Fehler melden