Articoli su: Strumenti e interfacce
Questo articolo è disponibile anche in:

Buildagil API openCDE


Si prega di osservare le Condizioni d'uso quando si utilizza l'API buildagil openCDE. In particolare, gestite i contenuti provenienti da buildagil in modo responsabile e garantite un adeguato livello di protezione dei dati. Buildagil non ha alcuna influenza sul trattamento dei contenuti al di fuori della piattaforma buildagil.


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


La documentazione OpenAPI dell'API buildagil openCDE è disponibile al seguente link: Documentazione OpenAPI


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.


L'accesso a buildagil tramite l'API buildagil openCDE può essere limitato in base al progetto. A tal fine, si prega di contattare l'assistenza. Nel prossimo futuro questa opzione sarà disponibile nelle impostazioni del progetto.


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