API REST

PRÉSENTATION DE L'API

AI ARTEDUSA expose une API REST construite avec FastAPI, vous permettant d'intégrer votre centre d'appels IA à vos outils existants. Le schéma OpenAPI décrit l'ensemble des endpoints.

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

AUTHENTIFICATION

L'API s'authentifie via le jeton de session :

• JWT de session : incluez le jeton dans l'en-tête Authorization: Bearer <token>. Ce jeton, obtenu lors de la connexion, authentifie toutes vos requêtes.

ENDPOINTS PRINCIPAUX

Voici les catégories d'endpoints disponibles :

• GET /api/v1/tenants/{tenant_id}/calls : liste des appels (pagination + filtres canal/dates/recherche)
• GET /api/v1/tenants/{tenant_id}/calls/{call_id} : détail d'un appel (transcription, synthèse, métadonnées)
• GET /api/v1/tenants/{tenant_id}/knowledge : liste des documents de la base de connaissances
• POST /api/v1/tenants/{tenant_id}/knowledge : ajouter un document
• DELETE /api/v1/tenants/{tenant_id}/knowledge/{item_id} : supprimer un document
• POST /api/v1/tenants/{tenant_id}/knowledge/sync : lancer la synchronisation de la base de connaissances
• GET /api/v1/ai-agents/{agent_id} : récupérer la configuration du bot
• PUT /api/v1/ai-agents/{agent_id} : 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 :

• 200 requêtes par minute par tenant sur les endpoints appels et base de connaissances
• 100 requêtes par minute (par adresse IP) sur les endpoints de configuration (ai-agents, workspace)
• 10 téléversements de documents par minute
• Les requêtes excédentaires reçoivent une réponse 429 (Too Many Requests)