Buildagil API openCDE
- Possibilità
- Autenticazione
- Visibilità e autorizzazioni
- Dintorni
- Limiti di quota
- Deep linking
- Condizioni d'uso
Possibilità
L'API openCDE di buildagil consente un'interazione fluida con buildagil e offre numerose funzioni e strumenti per lo scambio di dati e l'integrazione con altri sistemi. Si basa sulla specifica API openCDE di BuildingSMART (BCF API / Documents API) ed è stata ampliata con endpoint, opzioni e campi aggiuntivi per offrire maggiore flessibilità e funzionalità.
L'API openCDE di buildagil offre, tra le altre cose, le seguenti funzionalità:
- Ricerca dei contenuti tra più progetti o all’interno di un singolo progetto
- Visualizzare, creare e modificare incarichi personali
- Visualizzare le informazioni sul progetto
- Visualizzare, creare e modificare incarichi e temi
- Recuperare, caricare, spostare e modificare documenti
- Richiedere le versioni dei documenti
- Recuperare e modificare i metadati dei documenti
- Visualizzare le riunioni
- Visualizza i traguardi fondamentali
- Recupera utente
- Rispondere alla creazione di incarichi e temi, documenti, riunioni, traguardi e utenti
- Reagire alle modifiche relative agli incarichi e ai temi, ai documenti, alle riunioni e ai traguardi
Autenticazione
L'autenticazione si basa sulla Microsoft Identity Platform e avviene tramite il flusso di autorizzazione OAuth 2.0 con accesso basato sull'utente. Ogni accesso è associato a un singolo utente. Per ulteriori informazioni sul flusso di autorizzazione tramite codice, consultare il seguente articolo: Piattaforma di identità Microsoft e flusso di autorizzazione OAuth 2.0.
Per l'autenticazione all'API buildagil openCDE, si prega di contattare l'assistenza indicando un URL di callback per ricevere l'ID cliente e il segreto cliente.
Visibilità e autorizzazioni
Per il recupero e la modifica dei contenuti tramite l'API openCDE di buildagil si applicano le stesse impostazioni di visibilità e autorizzazioni basate sull'utente in vigore su buildagil. Maggiori dettagli sono disponibili all'indirizzo Visibilità e autorizzazioni.
Dintorni
Per l'API buildagil openCDE è disponibile esclusivamente un ambiente di produzione.
Limiti di frequenza
L'API openCDE di buildagil utilizza un sistema di limitazione della velocità dinamico e basato sull'utente. In caso di utilizzo elevato, è possibile che tale velocità venga limitata in base all'utente. Si raccomanda di eseguire operazioni di ampia portata (come ad esempio il recupero o il caricamento di grandi quantità di dati) nelle ore di minor traffico.
Deep linking
Per aprire direttamente i contenuti su buildagil o per rimandarvi, è possibile utilizzare la proprietà "link" nella rispettiva risposta.
Condizioni d'uso
L'API viene messa a disposizione per gli scopi sopra descritti secondo il principio del "fair use". Funzioni, strutture dei dati, endpoint e limitazioni tecniche o relative all'utilizzo possono essere adattati o modificati nell'ambito dell'ulteriore sviluppo. Le modifiche pianificate e attuate saranno pubblicate nel Novità e aggiornamenti.
Gli utenti dell'API sono responsabili della conservazione sicura delle credenziali di accesso e dei token, nonché dell'utilizzo sicuro e corretto dell'API. È vietato eludere i meccanismi di sicurezza, le restrizioni di accesso e i limiti di frequenza.
Gli utenti sono inoltre tenuti a gestire in modo responsabile e adeguato i dati ottenuti tramite l’API e a rispettare in ogni momento tutti i requisiti legali, di sicurezza e di protezione dei dati. Buildagil non ha alcuna influenza sul trattamento dei dati al di fuori di buildagil. Gli utenti sono inoltre responsabili di tutte le azioni attivate tramite l’API, indipendentemente dal fatto che siano state avviate manualmente o in modo automatizzato (anche tramite IA).
Per il resto, si applicano le disposizioni contenute in Condizioni generali di utilizzo di buildagil.
openCDE, OpenAPI, API, BCF API, OAuth 2.0, flusso del codice di autorizzazione, Microsoft Identity Platform, accesso basato sull'utente, ID client, segreto client, ambiente di produzione, ambiente di test, autenticazione API
Aggiornato il: 18/11/2026
