API REST

PRÉSENTATION DE L'API

AI ARTEDUSA expose une API REST complète construite avec FastAPI, vous permettant d'intégrer votre centre d'appels IA à vos outils et processus existants. L'API est documentée automatiquement via Swagger (OpenAPI) et accessible depuis votre tableau de bord.

L'API utilise le format JSON pour les requêtes et les réponses, avec des codes de statut HTTP standard.

AUTHENTIFICATION

L'API utilise deux modes d'authentification selon le type d'endpoint :

• JWT Supabase (routes utilisateur) : Incluez le jeton JWT dans l'en-tête Authorization: Bearer <token>. Ce jeton est obtenu lors de la connexion.
• Clé API (routes admin) : Utilisez l'en-tête X-API-Key: <votre_clé>. La clé API est disponible dans les paramètres de votre compte.

ENDPOINTS PRINCIPAUX

Voici les catégories d'endpoints disponibles :

• GET /api/calls : Liste des appels avec pagination et filtres
• GET /api/calls/{id} : Détail d'un appel (transcription, synthèse, métadonnées)
• GET /api/documents : Liste des documents de la base de connaissances
• POST /api/documents : Ajouter un document
• PUT /api/documents/{id} : Modifier un document
• DELETE /api/documents/{id} : Supprimer un document
• POST /api/sync : Lancer la synchronisation Qdrant
• GET /api/config : Récupérer la configuration du bot
• PUT /api/config : Modifier la configuration du bot

LIMITES ET BONNES PRATIQUES

L'API est soumise à des limites de débit (rate limiting) pour garantir la stabilité du service :

• 100 requêtes par minute par tenant pour les endpoints de lecture (GET)
• 20 requêtes par minute par tenant pour les endpoints d'écriture (POST, PUT, DELETE)
• Les requêtes excédentaires recevront une réponse 429 (Too Many Requests)