Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Connect ai servizi con OpenAPI
<a name="connectors-openapi"></a>

Per connettere App Studio ai servizi che utilizzano OpenAPI per consentire ai builder di creare applicazioni che inviano richieste e ricevono risposte dai servizi, procedi nel seguente modo:

1. [Ottieni il file delle specifiche OpenAPI e raccogli informazioni sul servizio](#connectors-openapi-create-resources)

1. [Crea connettore OpenAPI](#connectors-openapi-create-connector)

## Ottieni il file delle specifiche OpenAPI e raccogli informazioni sul servizio
<a name="connectors-openapi-create-resources"></a>

Per connettere un servizio ad App Studio con OpenAPI, procedi nel seguente modo:

1. Vai al servizio che desideri connettere ad App Studio e trova un file JSON delle specifiche OpenAPI.
**Nota**  
App Studio supporta i file di specifica OpenAPI conformi alla versione OpenAPI Specification versione 3.0.0 o successiva.

1. Raccogli i dati necessari per configurare il connettore OpenAPI, inclusi i seguenti:
   + L'URL di base per la connessione al servizio.
   + Credenziali di autenticazione, come un token o un nome utente/password.
   + Se applicabile, eventuali intestazioni.
   + Se applicabile, eventuali parametri di interrogazione.

## Crea connettore OpenAPI
<a name="connectors-openapi-create-connector"></a>

**Per creare un connettore per OpenAPI**

1. Vai ad App Studio.

1. Nel riquadro di navigazione a sinistra, scegli **Connettori** nella sezione **Gestisci**. Verrai indirizzato a una pagina che mostra un elenco di connettori esistenti con alcuni dettagli su ciascuno di essi.

1. Scegli **\$1 Crea connettore**.

1. Scegli **OpenAPI Connector** dall'elenco dei tipi di connettore. Ora configura il tuo connettore compilando i seguenti campi.

1. **Nome:** inserisci un nome per il tuo connettore OpenAPI.

1. **Descrizione:** inserisci una descrizione per il tuo connettore OpenAPI.

1. **URL di base:** inserisci l'URL di base per la connessione al servizio.

1. **Metodo di autenticazione:** scegli il metodo di autenticazione con il servizio di destinazione.
   + **Nessuno:** accedi al servizio di destinazione senza autenticazione.
   + **Base:** accedi al servizio di destinazione utilizzando un **nome utente** e una **password** ottenuti dal servizio a cui ci si connette.
   + **Bearer Token:** accedi al servizio di destinazione utilizzando il **valore Token** di un token di autenticazione ottenuto dall'account utente o dalle impostazioni API del servizio.
   + **OAuth 2.0:** accedi al servizio di destinazione utilizzando il protocollo OAuth 2.0, che consente ad App Studio di accedere al servizio e alle risorse senza condividere credenziali o identità. Per utilizzare il metodo di autenticazione OAuth 2.0, è necessario innanzitutto creare un'applicazione dal servizio a cui ci si connette che rappresenti App Studio per ottenere le informazioni necessarie. Con queste informazioni, compila i seguenti campi:

     1. **Flusso delle credenziali del cliente:**

        1. In **Client ID**, inserisci l'ID del servizio di destinazione.

        1. In **Client secret**, inserisci il segreto del servizio di destinazione.

        1. In **Access token URL**, inserisci l'URL del token dal servizio di destinazione.

        1. Facoltativamente, in **Scopes**, inserisci gli ambiti per l'applicazione. Gli ambiti sono le autorizzazioni o i livelli di accesso richiesti dall'applicazione. Fai riferimento alla documentazione dell'API del servizio di destinazione per comprenderne gli ambiti e configura solo quelli necessari all'app App Studio.

        Aggiungi tutte **le variabili** da inviare con il servizio a ogni chiamata e scegli **Verifica connessione** per testare l'autenticazione e la connessione.

     1. **Flusso del codice di autorizzazione:**

        1. In **Client ID**, inserisci l'ID del servizio di destinazione.

        1. In **Client secret**, inserisci il segreto del servizio di destinazione.

        1. In **URL di autorizzazione**, inserisci l'URL di autorizzazione dal servizio di destinazione.

        1. In **URL del token di accesso**, inserisci l'URL del token dal servizio di destinazione.

        1. Facoltativamente, in **Scopes**, inserisci gli ambiti per l'applicazione. Gli ambiti sono le autorizzazioni o i livelli di accesso richiesti dall'applicazione. Fai riferimento alla documentazione dell'API del servizio di destinazione per comprenderne gli ambiti e configura solo quelli necessari all'app App Studio.

1. **Variabili:** aggiungi variabili da inviare al servizio ad ogni chiamata. Le variabili aggiunte durante la configurazione vengono archiviate in modo sicuro e vi si accede solo durante l'esecuzione delle applicazioni che utilizzano la connessione.

1. **Intestazioni:** aggiungi intestazioni HTTP utilizzate per fornire metadati sulla richiesta o sulla risposta. È possibile aggiungere sia chiavi che valori o fornire solo una chiave a cui il builder può fornire un valore nell'applicazione.

1. **Parametri di query:** aggiungi parametri di query utilizzati per passare opzioni, filtri o dati come parte dell'URL della richiesta. Come le intestazioni, puoi fornire sia una chiave che un valore oppure fornire solo una chiave a cui il builder può fornire un valore nell'applicazione.

1. File **OpenAPI Spec: carica un file** JSON con specifiche OpenAPI trascinandolo o selezionando **Seleziona un file per navigare nel file system locale e scegli il file** da caricare.

   Una volta aggiunto, il file viene elaborato e viene visualizzato un elenco di opzioni disponibili. Seleziona le operazioni necessarie per il tuo connettore.

1. Scegli **Create** (Crea). Il connettore appena creato verrà visualizzato nell'elenco **Connettori**.

Ora che il connettore è stato creato, i builder possono utilizzarlo nelle loro app.