IVGraph-API-Dokumentation

Basis-URLs

Umgebung	URL
Produktionsumgebung	https://ivgraph.com/api/
Produktionsumgebung (V1)	https://ivgraph.com/v1/

Authentifizierung

IVGraph unterstützt zwei Authentifizierungsmethoden:

Methode	Anwendungsfall	Header
JWT (Notion OAuth)	Web-Apps, Nutzersitzungen	Authorization: Bearer <jwt_access_token>
Service-Token	LLM-Agenten, Automatisierung, CI/CD	Authorization: Bearer ivg_<token>

Schnellstart mit einem Service-Token

1. Melde dich auf ivgraph.com über Notion OAuth an
2. Gehe zu Profil → Service-Tokens
3. Erstelle ein Token mit den erforderlichen Berechtigungen (z. B. graph:search, graph:read)
4. Verwende das Token in deinen Anfragen:

curl -H "Authorization: Bearer ivg_your_token_here" \
  "https://ivgraph.com/v1/graph/search?q=project&workspace_id=YOUR_WORKSPACE_ID"

API-Ebenen

Ebene	Basispfad	Authentifizierung	Beschreibung
V1-LLM-API	/v1/graph/	Service-Token	Schreibgeschützter Graphzugriff für LLM-Agenten
Graph-API	/api/notion-graph/	JWT	Vollständige Graphdaten (Knoten + Kanten)
Such-API	/api/search/	JWT	Volltextsuche, semantische und hybride Suche
Interne API	/api/	JWT	Authentifizierung, Abrechnung, Integrationen, Stilregeln
Öffentlich	/api/stats/public/	Keine	Plattformstatistiken, Zustandsprüfungen

Anfragelimits

API	Limit	Geltungsbereich
V1 (Service-Token)	20 Anfragen/10s bei Lastspitzen, 600 Anfragen/15min	Pro Token
Nutzer-API (JWT)	100 Anfragen/min	Pro Nutzer
Anonym	20 Anfragen/min	Pro IP

Fehlerformat

Alle Fehler werden als JSON zurückgegeben:

{
  "error": "Short error message",
  "detail": "Extended description (optional)"
}

Die vollständige Fehlerreferenz findest du unter Fehler & Anfragelimits.

Für LLM-Agenten

Maschinenlesbare Dokumentation:

• ivgraph.com/llms.txt — kompakte API-Übersicht
• ivgraph.com/llms-full.txt — vollständige Dokumentation mit Beispielen