Zum Hauptinhalt springen
Die v3 API bietet vollständige RBAC-Unterstützung mit Service-User-Authentifizierung. Dies ist die empfohlene API für die Produktionsautomatisierung.
Die v3 API befindet sich derzeit in der Beta-Phase. Einige Endpunkte können sich ändern, während wir die API weiter verbessern.
Basis-URLs:
  • https://api.devin.ai/v3beta1/enterprise/* – Endpunkte, die Enterprise-Berechtigungen (Kontenebene) erfordern
  • https://api.devin.ai/v3beta1/organizations/* – Endpunkte, die auf eine einzelne Organisation beschränkt sind
Authentifizierung: Service-User-Anmeldedaten (auf Enterprise- oder Organisationsebene) (mehr erfahren)
Einige Enterprise-Endpunkte beziehen sich auf bestimmte Organisationen, werden aber weiterhin durch Berechtigungen auf Enterprise-Ebene geschützt. Diese verwenden Pfade wie /v3beta1/enterprise/organizations/{org_id}/... (zum Beispiel GET /v3beta1/enterprise/organizations/{org_id}/audit-logs). Auch wenn sie einen org_id-Pfadparameter enthalten, erfordern sie trotzdem Berechtigungen auf Enterprise-Ebene wie ManageEnterpriseSettings.

Berechtigungen und RBAC

Die v3-API verwendet Role-Based Access Control (RBAC) mit Servicebenutzern. Jeder Endpunkt erfordert bestimmte Berechtigungen, die der Rolle des Servicebenutzers zugewiesen werden. Servicebenutzer können entweder auf Enterprise- oder auf Organisationsebene erstellt werden, und ihre Berechtigungen bestimmen, auf welche Endpunkte sie zugreifen können.

Berechtigungstypen

Die v3 API verwendet die folgenden Berechtigungen:
BerechtigungBeschreibungEndpoints
ManageAccountKnowledgeKnowledge-Notizen auf Enterprise- oder Organisationsebene verwaltenNotes-Endpunkte (GET, POST, PUT, DELETE)
ManageAccountPlaybooksPlaybooks auf Enterprise- oder Organisationsebene verwaltenPlaybooks-Endpunkte (GET, POST, PUT, DELETE)
ManageEnterpriseSettingsUnternehmensweite Einstellungen, einschließlich Organisations-Tags, verwaltenTags-Endpunkte, Organisationsverwaltung

Geltungsbereiche von Servicebenutzern

Enterprise Service Users haben Zugriff auf unternehmensweite Ressourcen und können in allen Organisationen innerhalb des Enterprise-Kontos arbeiten. Sie verwenden Endpunkte unter /v3beta1/enterprise/*. Organization Service Users sind auf eine bestimmte Organisation beschränkt und können nur auf Ressourcen innerhalb dieser Organisation zugreifen. Sie verwenden Endpunkte unter /v3beta1/organizations/{org_id}/*.

Erstellen von Service-Benutzern

Service-Benutzer können erstellt werden über:
  • Enterprise-Einstellungen → Service Users: Erstellen Sie Service-Benutzer auf Enterprise- oder Organisationsebene mit benutzerdefinierten Rollen
Ausführliche Informationen zur Authentifizierung und zur Tokenerstellung finden Sie im Leitfaden zur Authentifizierung.

Self

Informationen zum authentifizierten Servicebenutzer abrufen:

Audit-Logs

Greifen Sie auf umfassende Audit-Protokolle zu:

Verbrauch

Detaillierte Verbrauchsmetriken verfolgen:

Organisationen

Verwalten Sie Organisationen mit umfassendem RBAC:

Servicebenutzer

Verwalten Sie Servicebenutzer auf Enterprise- und Organisationsebene:

Benutzer

Benutzer auf Enterprise- und Organisationsebene verwalten:

IdP-Gruppen

Verwalten Sie IdP-Gruppen auf Enterprise- und Organisationsebene:

Git-Berechtigungen

Repositoryzugriff verwalten:

Notizen

Verwalten Sie Knowledge-Notizen auf Enterprise- und Organisationsebene:

Playbooks

Verwalten Sie Playbooks auf Enterprise- und Organisationsebene:

Sitzungen

Sitzungen einer Organisation verwalten:

Tags

Organisationstags verwalten (erfordert die Session-Tags-Funktion):

Rollen & Metriken

Anwendungsbeispiele

Codebeispiele ansehen

Sehen Sie sich Codebeispiele und typische Anwendungsfälle für die v3 API an