> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://knowledge.buildagil.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Buildagil API openCDE


L'API openCDE di buildagil consente agli sviluppatori di interagire in modo fluido con buildagil e offre numerose funzioni e strumenti per facilitare lo scambio di dati e l'integrazione nei sistemi esistenti. Si basa sulla specifica API openCDE di [BuildingSMART](https://www.buildingsmart.org/) (BCF API / Documents API) ed è stata ampliata con endpoint, opzioni e campi aggiuntivi per offrire maggiore flessibilità e funzionalità.

| L'API buildagil openCDE è destinata agli sviluppatori o a chi possiede conoscenze di programmazione.

**Autenticazione**
Per l'autenticazione all'API buildagil openCDE, si prega di contattare l'assistenza indicando un URL di callback per ricevere l'ID client e il segreto client. Queste credenziali sono necessarie per autenticarsi all'API buildagil openCDE.

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 tramite codice di autorizzazione](https://learn.microsoft.com/en-us/entra/identity-platform/v2-oauth2-auth-code-flow).

**Dintorni**
Per l'API buildagil openCDE è disponibile esclusivamente l'ambiente di produzione. Per lo sviluppo e il collaudo viene utilizzato lo stesso ambiente.

**Possibilità**
L'API openCDE di buildagil offre, tra le altre cose, le seguenti funzionalità:
* Visualizzare le informazioni sul progetto
* Visualizzare, creare e aggiornare incarichi e temi
* Recuperare, caricare, spostare e aggiornare i documenti 
* Richiedere le versioni dei documenti
* Recuperare e aggiornare 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 relativa all'API buildagil openCDE è disponibile al seguente link: [Documentazione API buildagil openCDE](https://app.swaggerhub.com/apis-docs/buildagil/openCDE-API/1.0?view=elementsDocs)

**Deep linking**
È possibile creare deep link che rimandano direttamente a contenuti specifici all'interno di buildagil.
Esempio: https://app.buildagil.com/open?guid=xxx

**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 tali operazioni vengano limitate 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.

> openCDE, API, API BCF, 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