API openCDE de buildagil
- Possibilités
- Authentification
- Visibilité et autorisations
- Environs
- Limites de taux
- Liens profonds
- Conditions d'utilisation
Possibilités
L'API openCDE de buildagil permet une interaction fluide avec buildagil et offre de nombreuses fonctions et outils pour l'échange de données et l'intégration dans d'autres systèmes. Elle repose sur la spécification de l'API openCDE de BuildingSMART (API BCF / API Documents) et a été enrichie de points de terminaison, de possibilités et de champs supplémentaires afin d'offrir davantage de flexibilité et de fonctionnalités.
L'API openCDE de buildagil offre notamment les possibilités suivantes :
- Recherche du contenu dans l'ensemble des projets ou au sein d'un projet donné
- Consulter, créer et modifier des tâches personnelles
- Consulter les informations relatives au projet
- Consulter, créer et modifier des tâches et des sujets
- Consulter, télécharger, déplacer et modifier des documents
- Consulter les versions des documents
- Consulter et modifier les métadonnées des documents
- Consulter les réunions
- Consulter les jalons
- Afficher les utilisateurs
- Réagir à la création de tâches et de sujets, de documents, de réunions, de jalons et d'utilisateurs
- Réagir aux modifications apportées aux tâches et aux sujets, aux documents, aux réunions et aux jalons
Authentification
L'authentification repose sur la plateforme d'identité Microsoft et s'effectue via le flux de code d'autorisation OAuth 2.0 avec connexion par utilisateur. Chaque connexion est associée à un utilisateur unique. Pour plus d'informations sur le flux de code d'autorisation, consultez l'article suivant : Plateforme d'identité Microsoft et flux d'autorisation OAuth 2.0.
Pour vous authentifier auprès de l'API openCDE de buildagil, veuillez contacter le service d'assistance en indiquant une URL de rappel afin d'obtenir l'identifiant client et la clé secrète client.
Visibilité et autorisations
Pour la consultation et la modification de contenus via l'API openCDE de buildagil, les mêmes règles de visibilité et d'autorisations propres à chaque utilisateur s'appliquent que sur le reste de buildagil. Vous trouverez plus de détails à ce sujet à l'adresse Visibilité et autorisations.
Environs
L'API buildagil openCDE n'est disponible que dans un environnement de production.
Limites de débit
L'API openCDE de buildagil utilise une limitation de débit dynamique par utilisateur. En cas d'utilisation intensive, il peut arriver que le débit soit limité au niveau de l'utilisateur. Il est recommandé d'effectuer les opérations volumineuses (telles que la récupération ou le téléchargement de grandes quantités de données) pendant les heures creuses.
Liens profonds
Pour ouvrir directement des contenus sur buildagil ou y renvoyer, il est possible d'utiliser la propriété « link » dans la réponse correspondante.
Conditions d'utilisation
L'API est mise à disposition aux fins décrites ci-dessus, conformément au principe d'utilisation équitable. Les fonctions, les structures de données, les points de terminaison ainsi que les restrictions techniques ou liées à l'utilisation peuvent être adaptés ou modifiés dans le cadre du développement ultérieur. Les modifications prévues et mises en œuvre seront publiées dans le Actualités et mises à jour.
Les utilisateurs et utilisatrices de l'API sont responsables de la conservation sécurisée des identifiants et des jetons, ainsi que de l'utilisation sécurisée et conforme de l'API. Les mécanismes de sécurité, les restrictions d'accès et les limites de débit ne doivent pas être contournés.
Les utilisateurs sont en outre tenus de traiter de manière responsable et appropriée les données obtenues via l'API et de respecter à tout moment l'ensemble des exigences légales, de sécurité et de protection des données. Buildagil n'a aucune influence sur le traitement des données en dehors de buildagil. Les utilisateurs sont également responsables de toutes les actions déclenchées via l'API, qu'elles soient déclenchées manuellement ou de manière automatisée (y compris par l'IA).
Par ailleurs, les dispositions Conditions générales d'utilisation de buildagil s'appliquent.
openCDE, OpenAPI, API, API BCF, OAuth 2.0, flux de code d'autorisation, plateforme d'identité Microsoft, connexion basée sur l'utilisateur, ID client, secret client, environnement de production, environnement de test, authentification API
Mis à jour le : 18/11/2026
