L’API v3 est actuellement en bêta. Certains points de terminaison peuvent changer à mesure que nous améliorons l’API.
https://api.devin.ai/v3beta1/enterprise/*– points de terminaison qui nécessitent des autorisations Enterprise (au niveau du compte)https://api.devin.ai/v3beta1/organizations/*– points de terminaison limités à une seule organisation
Certains points de terminaison Enterprise s’appliquent à des organisations spécifiques, mais restent protégés
par des autorisations au niveau Enterprise. Ils utilisent des chemins du type
/v3beta1/enterprise/organizations/{org_id}/...
(par exemple, GET /v3beta1/enterprise/organizations/{org_id}/audit-logs).
Même s’ils incluent un paramètre de chemin org_id, ils exigent toujours
des autorisations au niveau Enterprise telles que ManageEnterpriseSettings.Autorisations et RBAC
Types d’autorisations
L’API v3 utilise les autorisations suivantes :| Autorisation | Description | Endpoints |
|---|---|---|
ManageAccountKnowledge | Gérer les notes Knowledge au niveau de l’Enterprise ou de l’organisation | Endpoints Notes (GET, POST, PUT, DELETE) |
ManageAccountPlaybooks | Gérer les playbooks au niveau de l’Enterprise ou de l’organisation | Endpoints Playbooks (GET, POST, PUT, DELETE) |
ManageEnterpriseSettings | Gérer les paramètres globaux de l’offre Enterprise, y compris les tags d’organisation | Endpoints Tags, gestion des organisations |
Périmètres des utilisateurs de service
/v3beta1/enterprise/*.
Les Organization Service Users sont limités à une organisation spécifique et ne peuvent accéder qu’aux ressources de cette organisation. Ils utilisent les endpoints sous /v3beta1/organizations/{org_id}/*.
Création d’utilisateurs de service
Les utilisateurs de service peuvent être créés via :- Paramètres Enterprise → Utilisateurs de service : créez des utilisateurs de service au niveau de l’Enterprise ou au niveau de l’organisation avec des rôles personnalisés
Self
Journaux d’audit
Journaux d’audit Enterprise
Obtenez les journaux d’audit à l’échelle de l’entreprise
Journaux d’audit d’organisation
Obtenez les journaux d’audit pour une organisation spécifique
Consommation
Cycles de consommation
Consultez les résumés des cycles de consommation
Consommation quotidienne
Consultez le détail de la consommation quotidienne
Par organisation
Suivez la consommation par organisation
Par utilisateur
Suivez la consommation par utilisateur
Par session
Suivez la consommation par session
Organisations
Liste des organisations
Afficher toutes les organisations
Créer une organisation
Créer une nouvelle organisation
Mettre à jour une organisation
Mettre à jour les paramètres de l’organisation
Supprimer une organisation
Supprimer une organisation
Utilisateurs de service
Afficher la liste des utilisateurs de service de l’entreprise
Afficher les utilisateurs de service de l’entreprise
Créer un utilisateur de service pour l’entreprise
Créer un utilisateur de service pour l’entreprise
Mettre à jour un utilisateur de service pour l’entreprise
Mettre à jour un utilisateur de service pour l’entreprise
Supprimer un utilisateur de service pour l’entreprise
Supprimer un utilisateur de service pour l’entreprise
Afficher la liste des utilisateurs de service de l’organisation
Afficher les utilisateurs de service de l’organisation
Créer un utilisateur de service pour l’organisation
Créer un utilisateur de service pour l’organisation
Utilisateurs
Lister les utilisateurs Enterprise
Afficher les utilisateurs Enterprise
Ajouter un utilisateur Enterprise
Ajouter un utilisateur à l’Enterprise
Mettre à jour un utilisateur Enterprise
Mettre à jour un utilisateur Enterprise
Supprimer un utilisateur Enterprise
Supprimer un utilisateur de l’Enterprise
Lister les utilisateurs d’organisation
Afficher les utilisateurs d’organisation
Ajouter un utilisateur d’organisation
Ajouter un utilisateur à une organisation
Groupes IdP
Lister les groupes IdP Enterprise
Afficher les groupes IdP de l’Enterprise
Ajouter un groupe IdP Enterprise
Ajouter un groupe IdP à l’Enterprise
Lister les groupes IdP d’organisation
Afficher les groupes IdP d’organisation
Ajouter un groupe IdP d’organisation
Ajouter un groupe IdP à une organisation
Autorisations Git
Lister les autorisations
Consulter les autorisations Git d’une organisation
Ajouter une autorisation
Ajouter une autorisation Git
Supprimer une autorisation
Supprimer une autorisation Git
Notes
Lister les notes Enterprise
Afficher les notes Knowledge au niveau Enterprise
Créer une note Enterprise
Créer une nouvelle note au niveau Enterprise
Lister les notes d'organisation
Afficher les notes Knowledge au niveau de l’organisation
Créer une note d'organisation
Créer une nouvelle note au niveau de l’organisation
Playbooks
Répertorier les playbooks Enterprise
Afficher les playbooks Enterprise
Créer un playbook Enterprise
Créer un nouveau playbook Enterprise
Répertorier les playbooks d’organisation
Afficher les playbooks d’organisation
Créer un playbook d’organisation
Créer un nouveau playbook d’organisation
Sessions
Lister les sessions
Afficher les sessions de l’organisation
Créer une session
Créer une nouvelle session
Consulter les tags
Afficher les tags d’une organisation
Ajouter des tags
Ajouter des tags à une organisation
Remplacer les tags
Remplacer tous les tags d’une organisation
Supprimer un tag
Supprimer un tag spécifique
Rôles et métriques
Lister les rôles
Afficher les rôles disponibles
Métriques d'utilisation Enterprise
Afficher les métriques d’utilisation Enterprise
Métriques d'utilisation de l'organisation
Afficher les métriques d’utilisation de l’organisation
Exemples d’utilisation
Voir les exemples de code
Découvrez des exemples de code et des cas d’usage courants de l’API v3