Die Devin-API ermöglicht es dir, Devin in deine Anwendungen zu integrieren, Workflows zu automatisieren und leistungsstarke Tools zu entwickeln. Wir bieten drei API-Versionen an, die jeweils für unterschiedliche Anwendungsfälle und Authentifizierungsmodelle ausgelegt sind.
Devin bietet drei API-Versionen mit unterschiedlichem Funktionsumfang und verschiedenen Authentifizierungsanforderungen:
Externe API v1 (organisationsweit, Org-Scoped)
Die v1-API stellt zentrale Funktionen für das Sitzungsmanagement mit organisationsweitem Zugriff bereit.
Basis-URL: https://api.devin.ai/v1/*
Authentifizierung: Persönliche oder Service API Keys
Hauptfunktionen:
- Devin-Sitzungen erstellen und verwalten
- Nachrichten an aktive Sitzungen senden
- Secrets, Knowledge und Playbooks verwalten
- Anhänge hoch- und herunterladen
- Session-Tags aktualisieren
Am besten geeignet für:
- Allgemeine Automatisierung von Sitzungen
- Benutzerorientierte Integrationen
- CI/CD-Pipelines
- Entwicklung und Tests
v1-API-Dokumentation ansehen →
Enterprise-API v2 (nur für Enterprise-Administrator:innen)
Die v2-API bietet unternehmensweite Verwaltungs- und Analysefunktionen.
Basis-URL: https://api.devin.ai/v2/enterprise/*
Authentifizierung: Nur persönliche API Keys von Enterprise-Administrator:innen
Wichtige Funktionen:
- Unternehmensweite Sitzungsanalysen und Einblicke
- Verwaltung von Organisationen und Mitgliedern
- Verbrauchsnachverfolgung und Abrechnungsdaten
- Audit-Logs und Compliance-Berichte
- Verwaltung von Git-Berechtigungen
- Repository-Indizierung
Am besten geeignet für:
- Enterprise-Administrator:innen
- Analysen und Reporting
- Compliance und Audits
- Organisationsverwaltung
v2-API-Dokumentation anzeigen →
Service User API v3 (RBAC)
Die v3 API bietet vollständige RBAC-Unterstützung mit Servicebenutzer-Authentifizierung.
Basis-URLs:
https://api.devin.ai/v3beta1/enterprise/*
https://api.devin.ai/v3beta1/organizations/*
Authentifizierung: Servicebenutzer-Zugangsdaten (Enterprise- oder Organisationsebene)
Hauptfunktionen:
- Vollständige rollenbasierte Zugriffskontrolle (RBAC)
- Servicebenutzer mit dedizierten Rollen
- Feingranulare Berechtigungen
- Workflows über mehrere Organisationen hinweg
- Klare Trennung zwischen menschlichen Konten und Service-Konten
Am besten geeignet für:
- Produktionsautomatisierung mit spezifischen Berechtigungen
- Integrationen über mehrere Organisationen
- Compliance-kritische Workflows
- Dauerhafte Service-Integrationen
v3-API-Dokumentation anzeigen →
- Für die v1-API: Generieren Sie einen API key unter Settings > API Keys in einer beliebigen Unterorganisation.
- Für die v2-API: Generieren Sie einen persönlichen API key unter Settings > API Keys in einer beliebigen Unterorganisation.
- Für die v3-API: Erstellen Sie einen Servicebenutzer unter Enterprise Settings > Service Users.
Bewahren Sie Ihre API keys sicher auf und geben Sie sie niemals in öffentlich zugänglichen Bereichen wie GitHub-Repositories oder client-seitigem Code weiter.
Führen Sie Ihre erste Anfrage aus
Fügen Sie Ihren API key im Authorization-Header ein:
Authorization: Bearer your_api_key_here
Beispiel – So erstellen Sie eine v1-Session:
curl -X POST "https://api.devin.ai/v1/sessions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Erstelle ein einfaches Python-Skript, das Hello World ausgibt"
}'
Alle APIs verwenden standardisierte HTTP-Statuscodes:
200 OK: Erfolgreiche Anfrage
201 Created: Ressource erfolgreich erstellt
400 Bad Request: Ungültige Anfrageparameter
401 Unauthorized: Fehlender oder ungültiger API key
403 Forbidden: Unzureichende Berechtigungen
404 Not Found: Ressource nicht gefunden
429 Too Many Requests: Anfragelimit überschritten
500 Internal Server Error: Serverfehler
Bei Fragen zur API oder um Probleme zu melden, senden Sie eine E-Mail an [email protected].