API Documentation
Documentation complète de l'API Devana.ai pour intégrer l'intelligence artificielle dans vos applications.
Base URL : https://api.devana.ai
Authentification : Bearer token (clé API)
Format : JSON
Protocole : HTTPS uniquement
📑 Table des matières
- Authentification
- Endpoints
- Intégration
- Démarrage rapide
- Exemples
- Gestion des erreurs
- Limites et quotas
Authentification
Toutes les requêtes API nécessitent une clé API fournie dans le header Authorization.
Documentation complète : OAuth 2.0
Authorization: Bearer YOUR_API_KEY
Obtenir une clé API :
- Créez un compte sur app.devana.ai
- Accédez à Paramètres → API
- Générez une nouvelle clé API
Endpoints
Agents
Gestion des agents IA
| Endpoint | Description | Documentation |
|---|---|---|
GET /v1/agents | Lister tous vos agents | agents.md |
GET /v1/agents/:id | Récupérer un agent spécifique | agents.md |
POST /v1/agents | Créer un nouvel agent | agents.md |
PUT /v1/agents/:id | Mettre à jour un agent | agents.md |
Documentation complète :
- Agents API - Endpoints internes (gestion complète)
- Agents Public API - Endpoints publics (accès restreint)
Gestion des fichiers
Upload et gestion de documents
| Endpoint | Description | Documentation |
|---|---|---|
POST /api/upload | Upload multi-fichiers (jusqu'à 5000) | files.md |
GET /v1/folders | Lister tous les dossiers | folders.md |
POST /v1/folders | Créer un dossier | folders.md |
GET /v1/documents/:id | Récupérer le contenu d'un document | documents.md |
Documentation complète :
- File Upload API - Upload de fichiers avec extraction de contenu
- Folders API - Gestion des dossiers (bases de connaissances)
- Documents API - Extraction et traitement de documents
- Formats supportés - Liste complète des formats de fichiers acceptés
Conversations & Completions
Génération de texte et gestion des conversations
| Endpoint | Description | Documentation |
|---|---|---|
POST /v1/chat/completions | Créer une conversation avec un agent | completions.md |
GET /v1/conversations | Lister les conversations | conversations.md |
GET /v1/conversations/:id | Récupérer une conversation | conversations.md |
GET /v1/conversations/:id/metrics | Métriques détaillées d'une conversation | conversations.md |
Documentation complète :
- Chat Completions - Endpoint principal pour converser avec les agents
- Conversations API - CRUD des conversations et métriques
- Public Conversations - Conversations publiques et widgets embedables
- Interactions - Feedback et actions utilisateur
Système & Monitoring
Suivi et gestion des tâches asynchrones
| Endpoint | Description | Documentation |
|---|---|---|
GET /v1/jobs | Liste et suivi des tâches asynchrones | jobs.md |
Documentation complète :
- Jobs API - Monitoring des tâches asynchrones (extraction, embeddings, etc.)
Intégration
Intégrer Devana.ai dans vos applications
- IFrame Integration - Intégrer Devana.ai directement dans vos pages web
- IFrame Examples - Exemples concrets d'intégration (chatbot, assistant)
- Tools - Configuration et utilisation des outils (API calls, webhooks)
Démarrage rapide
Étape 1 : Obtenir une clé API
- Créez un compte sur app.devana.ai
- Accédez à Paramètres → API
- Cliquez sur "Générer une nouvelle clé"
- Copiez et conservez votre clé en lieu sûr
Étape 2 : Premier appel API
Lister vos agents :
curl -X GET https://api.devana.ai/v1/agents \
-H "Authorization: Bearer YOUR_API_KEY"
Réponse :
{
"success": true,
"data": [
{
"id": "cm123abc",
"name": "Assistant Support",
"model": "gpt-4o",
"publicChat": false
}
]
}
Étape 3 : Créer une conversation
curl -X POST https://api.devana.ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"agentId": "cm123abc",
"messages": [
{"role": "user", "content": "Bonjour, peux-tu m'\''aider ?"}
]
}'
Réponse :
{
"success": true,
"data": {
"id": "conv_abc123",
"message": "Bonjour ! Bien sûr, je suis là pour vous aider. Que puis-je faire pour vous ?",
"model": "gpt-4o",
"tokens": 45,
"sources": []
}
}
Exemples
Conversation avec RAG (Retrieval Augmented Generation)
curl -X POST https://api.devana.ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"agentId": "cm123abc",
"messages": [
{"role": "user", "content": "Quelles sont les fonctionnalités principales de notre produit ?"}
]
}'
L'agent utilisera automatiquement les documents de sa base de connaissances pour répondre avec contexte.
Conversation streaming
curl -X POST https://api.devana.ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"agentId": "cm123abc",
"messages": [{"role": "user", "content": "Explique-moi l'\''IA"}],
"stream": true
}'
Plus d'exemples : completions.md
Gestion des erreurs
Tous les endpoints retournent des codes HTTP standards.
| Code | Signification | Action |
|---|---|---|
200 | Succès | Requête traitée correctement |
400 | Bad Request | Vérifier le format de la requête |
401 | Unauthorized | Clé API manquante ou invalide |
403 | Forbidden | Accès non autorisé à la ressource |
404 | Not Found | Ressource introuvable |
429 | Too Many Requests |
Format des erreurs :
{
"success": false,
"error": {
"code": "INVALID_AGENT_ID",
"message": "L'agent spécifié n'existe pas ou vous n'y avez pas accès"
}
}
Limites et quotas
Rate Limiting
Limites par défaut :
- 100 requêtes/minute par clé API
- 10 000 tokens/heure par agent
Headers de réponse :
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1640995200
Si limite dépassée :
{
"success": false,
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Trop de requêtes. Veuillez réessayer dans 42 secondes.",
"retryAfter": 42
}
}
Quotas
Configurable par agent via l'interface d'administration :
- Tokens maximum par mois
- Nombre de fichiers maximum
- Taille maximale de base de connaissances
Ressources
- Guide de déploiement - Déployer Devana.ai on-premise
- Changelogs - Historique des versions
- Formats supportés - Types de fichiers acceptés
- Requirements - Spécifications techniques
Support : support-it@devana.ai