Zum Hauptinhalt springen
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.

API-Versionen

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 →

Schnellstart

API-Schlüssel abrufen

  1. Für die v1-API: Generieren Sie einen API key unter Settings > API Keys in einer beliebigen Unterorganisation.
  2. Für die v2-API: Generieren Sie einen persönlichen API key unter Settings > API Keys in einer beliebigen Unterorganisation.
  3. 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"
  }'

Fehlerbehandlung

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

Support

Bei Fragen zur API oder um Probleme zu melden, senden Sie eine E-Mail an [email protected].