Skip to main content
Chaque endpoint de l’API est protégé par une autorisation spécifique associée au rôle de l’utilisateur de service appelant. L’autorisation requise pour chaque endpoint est indiquée sur sa page de référence API dédiée. Cette page fournit un aperçu de toutes les autorisations par périmètre. URLs de base :
  • https://api.devin.ai/v3/organizations/* — endpoints limités à une seule organisation
  • https://api.devin.ai/v3/enterprise/* — endpoints qui nécessitent des autorisations de niveau Enterprise
Les clients Devin Enterprise disposant d’un déploiement dédié doivent remplacer api.devin.ai par leur domaine API personnalisé (par exemple, api.your-company.devinenterprise.com). Consultez le guide de démarrage rapide Enterprise pour plus de détails sur la configuration.
Trouvez l’identifiant de votre organisation sur la page Settings → Service Users.
Certains endpoints Enterprise opèrent sur des organisations spécifiques en utilisant des chemins comme /v3/enterprise/organizations/{org_id}/... (par exemple, journaux d’audit et tags). Même s’ils incluent un paramètre org_id, ils nécessitent des autorisations de niveau Enterprise.

​
Enterprise permissions

​
Autorisations d’organisation

​
Héritage des autorisations

Les utilisateurs de service Enterprise s’authentifient via les endpoints /v3/enterprise/* et peuvent agir sur l’ensemble des organisations. Ils se voient attribuer des rôles au niveau Enterprise et héritent automatiquement, dans chaque organisation, des autorisations correspondantes au niveau de l’organisation (par exemple, ViewAccountSessions accorde ViewOrgSessions dans toutes les organisations). Les utilisateurs de service d’organisation sont limités à une seule organisation et s’authentifient uniquement via les endpoints /v3/organizations/{org_id}/*. Ils se voient attribuer des rôles au niveau de l’organisation.

​
Création d’utilisateurs de service

Les utilisateurs de service sont créés dans l’interface Devin :
  1. Utilisateurs de service Enterprise : Enterprise settings → Service Users
  2. Utilisateurs de service d’organisation : Organization settings → Service Users
Pour la procédure de configuration, consultez le guide de démarrage rapide pour les équipes ou le guide de démarrage rapide Enterprise.