Endpoints API Devana.ai

Guide de navigation pour choisir les bons endpoints selon vos besoins.

🎯 Quelle API utiliser ?

🔐 Agents - API Privée (Gestion complète)

📄 Documentation : agents.md

Utilisez cette API si vous voulez :

• Gérer vos agents (création, modification, suppression)
• Lister tous vos agents
• Récupérer les détails complets d'un agent (configuration avancée)
• Ajouter des fichiers à un agent
• Gérer les tools actifs sur un agent
• Accéder aux conversations d'un agent

Authentification : Clé API privée (Bearer token)

Endpoints principaux :

• GET /v1/agents - Liste tous vos agents
• POST /v1/agents - Créer un agent
• GET /v1/agent/:id - Récupérer un agent (détaillé)
• PUT /v1/agents/:id - Mettre à jour un agent
• DELETE /v1/agents/:id - Supprimer un agent

🌐 Agents - API Publique (Intégration frontend)

📄 Documentation : agents-public.md

Utilisez cette API si vous voulez :

• Intégrer un agent dans votre application web
• Créer des conversations publiques pour vos utilisateurs finaux
• Générer des tokens de session pour vos utilisateurs
• Permettre à vos utilisateurs de discuter avec un agent sans authentification

Authentification : Clé API publique (Bearer token) + tokens de session

Endpoints principaux :

• GET /v1/chat/conversation/public/message/token - Générer un token de session
• GET /v1/chat/conversation/public/messages/:token - Récupérer les messages
• POST /v1/chat/conversation/public/message - Envoyer un message

⚠️ Important : Cette API est conçue pour être appelée depuis votre backend pour générer des tokens, puis utilisée depuis votre frontend avec ces tokens.

💬 Conversations

API Privée (Gestion)

📄 Documentation : conversations.md

Pour :

• Gérer vos conversations privées
• Récupérer les métriques détaillées
• Supprimer des conversations
• Lister toutes vos conversations

Authentification : Clé API privée

API Publique (Widgets)

📄 Documentation : public-conversations.md

Pour :

• Créer des conversations publiques embedables
• Intégrer des widgets de chat
• Gérer les conversations publiques

Authentification : Clé API publique

🚀 Autres endpoints

Chat Completions

📄 Documentation : completions.md

Endpoint principal pour converser avec les agents (streaming, RAG, tools).

Gestion des fichiers

📄 Documentation : files.md

Upload multi-fichiers (jusqu'à 5000) avec extraction de contenu.

Dossiers (Bases de connaissances)

📄 Documentation : folders.md

Gestion des dossiers et bases de connaissances pour vos agents.

Documents

📄 Documentation : documents.md

Extraction et traitement de documents avec Odin.

Interactions

📄 Documentation : interactions.md

Feedback utilisateur et actions sur les conversations.

Jobs

📄 Documentation : jobs.md

Monitoring des tâches asynchrones (extraction, embeddings, etc.).

🔍 Tableau récapitulatif

📖 Ressources complémentaires

• Documentation API complète
• Authentification OAuth 2.0
• Formats supportés
• Guide d'intégration IFrame
• Configuration des Tools