L’API Devin vous permet d’intégrer Devin à vos applications, d’automatiser vos workflows et de créer des outils puissants. Nous proposons trois versions d’API, chacune conçue pour des cas d’usage et des modèles d’authentification différents.
Devin propose trois versions de l’API avec des fonctionnalités et des exigences d’authentification différentes :
API externe v1 (portée organisationnelle)
https://api.devin.ai/v1/*
Authentification : Clés d’API personnelles ou de service
Fonctionnalités principales :
- Créer et gérer des sessions Devin
- Envoyer des messages aux sessions actives
- Gérer les secrets, Knowledge et les playbooks
- Téléverser et télécharger des pièces jointes
- Mettre à jour les étiquettes de session
Idéale pour :
- Automatisation générale des sessions
- Intégrations orientées vers les utilisateurs
- Pipelines CI/CD
- Développement et tests
Voir la documentation de l’API v1 →
API Enterprise v2 (administrateur Enterprise uniquement)
https://api.devin.ai/v2/enterprise/*
Authentification : API keys personnelles d’administrateurs Enterprise uniquement
Fonctionnalités clés :
- Analyses et insights de session à l’échelle de l’entreprise
- Gestion des organisations et des membres
- Suivi de la consommation et données de facturation
- Journaux d’audit et rapports de conformité
- Gestion des autorisations Git
- Indexation des dépôts
Idéal pour :
- Administrateurs Enterprise
- Analyses et reporting
- Conformité et audit
- Gestion des organisations
Afficher la documentation de l’API v2 →
API pour utilisateurs de service v3 (RBAC)
https://api.devin.ai/v3beta1/enterprise/*https://api.devin.ai/v3beta1/organizations/*
Authentification : identifiants d’utilisateur de service (au niveau Enterprise ou Organisation)
Principales fonctionnalités :
- Contrôle d’accès basé sur les rôles (RBAC) complet
- Utilisateurs de service avec rôles dédiés
- Autorisations granulaires
- Flux de travail multi-organisations
- Séparation claire entre comptes humains et comptes de service
Idéal pour :
- Automatisation en production avec des autorisations spécifiques
- Intégrations multi-organisations
- Flux de travail soumis à des exigences strictes de conformité
- Intégrations de services de longue durée
Afficher la documentation de l’API v3 →
- Pour l’API v1 : générez une API key depuis Settings > API Keys dans n’importe quelle sous-organisation
- Pour l’API v2 : générez une API key personnelle depuis Settings > API Keys dans n’importe quelle sous-organisation
- Pour l’API v3 : créez un utilisateur de service depuis Enterprise Settings > Service Users
Conservez vos API keys en lieu sûr et ne les partagez jamais dans des espaces accessibles publiquement, tels que des dépôts GitHub ou du code côté client.
Effectuer votre première requête
Authorization :
Authorization: Bearer your_api_key_here
curl -X POST "https://api.devin.ai/v1/sessions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Créer un script Python simple qui affiche Hello World"
}'
Toutes les API utilisent les codes d’état HTTP standard :
200 OK: Requête réussie201 Created: Ressource créée avec succès400 Bad Request: Paramètres de la requête non valides401 Unauthorized: API key manquante ou invalide403 Forbidden: Droits insuffisants404 Not Found: Ressource introuvable429 Too Many Requests: Limite de requêtes dépassée500 Internal Server Error: Erreur interne du serveur
Pour toute question concernant l’API ou pour signaler un problème, contactez-nous à l’adresse [email protected].
