> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Gestire e usare integrazioni personalizzate
> Collega API condivise una sola volta e riutilizzale in ogni app del tuo workspace.
Le integrazioni del workspace ti permettono di registrare API esterne condivise a livello di workspace da una specifica OpenAPI. Importi una specifica (URL o JSON), selezioni fino a 30 operazioni e colleghi l'API una volta nel tuo workspace. Qualsiasi app in quel workspace può poi chiamare quelle operazioni approvate tramite `base44.integrations.custom.call()`, invece di configurare la propria connessione. Funziona sia per API interne sia per API partner da cui dipende il tuo team.
Queste integrazioni sono progettate per essere sicure e affidabili. Gli header di autenticazione sensibili vengono memorizzati come segreti del workspace crittografati e non vengono mai rinviati al browser. A runtime, le chiamate vengono proxate lato server con protezioni contro server side request forgery (SSRF), e gli header del workspace hanno la precedenza così le app non possono sovrascriverli. La modifica di un'integrazione usa la specifica memorizzata invece dell'URL live, e il salvataggio viene bloccato se gli header non riescono a caricarsi così non li perdi per errore.
**Importante:**
* L'accesso alle integrazioni del workspace è limitato agli admin e ai proprietari del workspace su un piano **Builder** o superiore.
* Qualsiasi membro del workspace può usare un'integrazione del workspace esistente nelle proprie app, anche su un piano gratuito.
***
## Comprendere le integrazioni del workspace
Un'integrazione del workspace è una connessione condivisa dal tuo workspace a un'API esterna o interna, come un CRM, un sistema di supporto o un backend personalizzato. La definisci una sola volta nel tuo workspace da una specifica OpenAPI o Swagger, scegli quali operazioni sono consentite, e qualsiasi app compatibile in quel workspace può chiamare quelle operazioni. Questo mantiene la configurazione in un unico posto e semplifica la gestione dei sistemi esterni su cui si affida il tuo team.
**Le integrazioni del workspace sono utili quando vuoi:**
* Usare la stessa API esterna o interna su più app nello stesso workspace.
* Mantenere dettagli sensibili come chiavi API e token in un unico posto sicuro, gestiti come segreti del workspace.
* Limitare quali endpoint sono disponibili così le app chiamano solo operazioni approvate e definite dalla specifica.
* Mantenere una chiara separazione dai connettori OAuth one-click, poiché le integrazioni del workspace sono gestite dal workspace e guidate dalla specifica.
* Rendere chiaro su quali sistemi esterni si affida il tuo workspace.
***
## Creare un'integrazione
Crea un'integrazione personalizzata del workspace quando vuoi esporre una nuova API esterna alle tue app e quell'API ha una specifica OpenAPI o Swagger. Base44 legge la specifica, ti permette di scegliere gli endpoint che vuoi esporre e crea un'integrazione riutilizzabile per il tuo workspace.
**Prima di iniziare:** Assicurati di avere accesso a una specifica OpenAPI o Swagger valida per l'API che vuoi usare. Puoi hostarla su un URL pubblico o copiare il JSON.
### Passaggio 1 | Aggiungi una nuova integrazione
1. Clicca sul nome del tuo workspace in alto a sinistra nel tuo account.
2. Clicca su **Settings**.
3. Clicca su **Integrations**.
4. Clicca su **New Integration**.
5. Scegli come vuoi fornire la specifica dell'API:
* **From URL:** Inserisci l'URL pubblico del tuo file OpenAPI o Swagger nel campo **OpenAPI Specification URL**, ad esempio `https://api.example.com/openapi.json`.
* **Paste JSON:** Incolla la definizione JSON completa della tua specifica OpenAPI o Swagger nell'editor.
6. Clicca su **Continue**.
### Passaggio 2 | Seleziona gli endpoint da esporre
Seleziona fino a 30 endpoint per la tua integrazione.
**Per selezionare gli endpoint:**
1. Rivedi l'elenco degli endpoint che Base44 scopre dalla tua specifica. Puoi usare la casella di ricerca per trovare percorsi o operazioni specifici per metodo o nome del percorso.
2. Seleziona le caselle di controllo per gli endpoint che vuoi esporre al tuo workspace.
3. Clicca su **Continue**.
### Passaggio 3 | Configura la tua integrazione
Configura i dettagli dell'integrazione, imposta l'URL base e aggiungi eventuali header personalizzati necessari alla tua API. I valori degli header sensibili restano protetti. Gli header di autenticazione comuni come `authorization`, `x-api-key`, `api-key`, `x-auth-token`, `x-access-token`, `x-secret-key`, `bearer`, `secret`, `password` e `credential` vengono sempre trattati come segreti. I loro valori vengono memorizzati come segreti del workspace crittografati, non vengono mai rinviati al browser e appaiono come "sensitive – delete to change" quando modifichi l'integrazione.
**Per configurare la tua integrazione:**
1. Imposta i dettagli per la tua integrazione:
* **Slug:** Inserisci un identificatore URL-friendly per l'integrazione, ad esempio `my-api`.
* **Name:** Inserisci il nome visualizzato che appare nell'elenco delle integrazioni del workspace.
* **Description:** Descrivi cosa fa l'integrazione così i colleghi sanno quando usarla.
* **Base URL:** Conferma o aggiorna l'URL base per la tua API.
2. Se la tua API richiede header che devono essere inviati con ogni richiesta, aggiungili nella sezione **Custom Headers**:
1. Clicca su **Add Header**.
2. Inserisci il nome dell'header, come `Authorization` o `X-API-Key`.
3. Inserisci il valore dell'header, come la tua chiave API o token.
4. Usa l'icona di visibilità per nascondere o rivelare il valore dell'header secondo necessità.
3. Rivedi l'elenco degli endpoint selezionati in fondo alla finestra di dialogo.
4. Clicca su **Create Integration**.
***
## Gestire le integrazioni del workspace
Dopo aver creato un'integrazione del workspace, appare nella scheda **Integrations** del tuo workspace. Da lì, puoi visualizzarne i dettagli, modificare le impostazioni o rimuoverla se non ti serve più.
### Visualizzare i dettagli dell'integrazione
1. Clicca sul nome del tuo workspace in alto a sinistra nel tuo account.
2. Clicca su **Settings**.
3. Clicca su **Integrations**.
4. Visualizza l'integrazione che vuoi ispezionare ed espandi gli endpoint.
### Modificare un'integrazione
1. Clicca sul nome del tuo workspace in alto a sinistra nel tuo account.
2. Clicca su **Settings**.
3. Clicca su **Integrations**.
4. Clicca sull'icona **More Actions** sulla card dell'integrazione.
5. Clicca su **Edit**.
6. Aggiorna i campi necessari e salva le modifiche.
Se hai bisogno di esporre endpoint aggiuntivi dalla stessa API, considera di creare una nuova integrazione o di aggiornare quella esistente in base a come vuoi che le app la usino.
### Eliminare un'integrazione
1. Clicca sul nome del tuo workspace in alto a sinistra nel tuo account.
2. Clicca su **Settings**.
3. Clicca su **Integrations**.
4. Clicca sull'icona **More Actions** sulla card dell'integrazione.
5. Clicca su **Delete**.
6. Clicca di nuovo su **Delete** per confermare che vuoi rimuoverla dal workspace.
**Importante:** Eliminare un'integrazione del workspace può interrompere qualsiasi integrazione a livello di app che ne dipenda. Assicurati di rivedere le app attive prima di rimuovere un'integrazione condivisa.
***
## FAQ
Clicca su una domanda qui sotto per saperne di più sulle integrazioni del workspace.
Dopo aver creato un'integrazione del workspace, qualsiasi nuova app che costruisci in quel workspace può usarla.
Quando crei una nuova app, Base44 controlla le tue integrazioni del workspace. Se menzioni uno di quei sistemi nel tuo primo prompt, usa automaticamente l'integrazione del workspace corrispondente. Ad esempio, se hai già aggiunto un'integrazione API GitHub e dici "Create an app based on my GitHub issues," Base44 usa l'integrazione GitHub configurata per il workspace senza che tu debba selezionarla.
Puoi poi rivedere e modificare come l'app usa quell'integrazione dalle impostazioni delle integrazioni dell'app.
Per creare o gestire le integrazioni del workspace, devi essere un proprietario o admin del workspace su un piano Builder o superiore con accesso alla scheda **Integrations** nelle impostazioni del workspace. Se non vedi il pulsante **Add Integration** o le opzioni di modifica, contatta l'admin del tuo workspace e chiedigli di aggiornare il tuo ruolo o di creare l'integrazione per te.
Se il proprietario dell'API aggiorna la specifica all'URL che hai usato, i dettagli che Base44 legge da essa possono cambiare la prossima volta che aggiorni o ricrei l'integrazione. Quando sai che la specifica è cambiata, rivedi la tua integrazione del workspace e verifica che gli endpoint esposti corrispondano ancora a ciò che le tue app si aspettano.
I valori degli header come chiavi API e token vengono memorizzati come parte della configurazione dell'integrazione del workspace. Solo i colleghi con il permesso di gestire le integrazioni del workspace possono visualizzare o modificare questi valori. Usa l'icona di visibilità nel passaggio Configure per nascondere i valori sullo schermo quando lavori in spazi condivisi.
Sì. Puoi creare più integrazioni del workspace che puntano alla stessa API esterna. Ad esempio, potresti creare integrazioni separate per ambienti sandbox e produzione, o per diversi insiemi di endpoint usati da app diverse.
Quando hai bisogno di ruotare una chiave o un token, genera prima la nuova credenziale nel sistema esterno. Poi modifica l'integrazione del workspace, aggiorna il valore dell'header pertinente con la nuova chiave o token e salva le modifiche. Dopo aver aggiornato l'integrazione del workspace, le app che la usano iniziano a inviare automaticamente il nuovo valore.
Verifica che l'URL punti direttamente a un file OpenAPI o Swagger JSON o YAML valido e che sia accessibile pubblicamente dal tuo browser. Se il file è protetto da autenticazione o servito come HTML, Base44 non può analizzarlo.
Se vedi ancora errori, passa all'opzione Paste JSON, copia il JSON grezzo della tua specifica e riprova.
Per un test rapido, puoi anche provare una specifica valida conosciuta come un'API di esempio pubblica per confermare che il flusso funzioni.
Questa pagina è stata tradotta utilizzando l'IA. Per informazioni più accurate e aggiornate, consulta la [versione inglese](/).