Documentation de l’API IVGraph

URL de base

Environnement	URL
Production	https://ivgraph.com/api/
Production (V1)	https://ivgraph.com/v1/

Authentification

IVGraph prend en charge deux méthodes d’authentification :

Méthode	Cas d’usage	En-tête
JWT (OAuth Notion)	Applications web, sessions utilisateur	Authorization: Bearer <jwt_access_token>
Jeton de service	Agents LLM, automatisation, CI/CD	Authorization: Bearer ivg_<token>

Démarrage rapide avec un jeton de service

1. Connectez-vous sur ivgraph.com via OAuth Notion
2. Accédez à Profil → Jetons de service
3. Créez un jeton avec les portées requises (par exemple, graph:search, graph:read)
4. Utilisez le jeton dans vos requêtes :

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

Couches de l’API

Couche	Chemin de base	Authentification	Description
API V1 pour les LLM	/v1/graph/	Jeton de service	Accès au graphe en lecture seule pour les agents LLM
API du graphe	/api/notion-graph/	JWT	Données complètes du graphe (nœuds + arêtes)
API de recherche	/api/search/	JWT	Recherche plein texte, sémantique et hybride
API interne	/api/	JWT	Authentification, facturation, intégrations, règles de style
Publique	/api/stats/public/	Aucune	Statistiques de la plateforme, contrôles de bon fonctionnement

Limites de débit

API	Limite	Portée
V1 (jeton de service)	20 req/10s en rafale, 600 req/15min	Par jeton
API utilisateur (JWT)	100 req/min	Par utilisateur
Anonyme	20 req/min	Par IP

Format des erreurs

Toutes les erreurs sont renvoyées au format JSON :

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

Consultez Erreurs & limites de débit pour une description complète des erreurs.

Pour les agents LLM

Documentation lisible par machine :

• ivgraph.com/llms.txt — aperçu synthétique de l’API
• ivgraph.com/llms-full.txt — documentation complète avec exemples