Condividi tramite

Chiamare le proprie API Web e REST dai flussi di lavoro in Azure Logic Apps

Si applica a: Azure Logic Apps (Consumo + Standard)

Quando si dispone di API Web o API REST esistenti che si desidera chiamare dai flussi di lavoro in App per la logica di Azure, è necessario completare alcuni passaggi di configurazione prima di poter chiamare queste API. Principalmente, è necessario distribuire le API come app Web o app per le API. È possibile eseguire questa attività ospitando le API nel servizio app di Azure, una piattaforma cloud che offre hosting api altamente scalabile e semplice.

Nei Servizi app, è possibile distribuire le API come app Web, ma è opportuno valutare la possibilità di distribuire le API come app API. Questo approccio semplifica la compilazione, l'hosting e l'uso delle API nel cloud e negli ambienti locali. Non è necessario modificare il codice nelle API per la distribuzione in un'app per le API.

È possibile chiamare qualsiasi API da un flusso di lavoro, ma per un'esperienza ottimale, aggiungere metadati Swagger all'app Web o all'app per le API. Questo documento di Swagger descrive le operazioni e i parametri dell'API, che consentono ai flussi di lavoro delle app per la logica di funzionare meglio e più facilmente con l'API. È anche necessario configurare la condivisione di risorse tra le origini (CORS) nell'app Web o nell'app per le API in modo che il flusso di lavoro possa accedere all'API.

Questa guida illustra come aggiungere un documento Swagger, configurare CORS per l'app Web o l'app per le API e fornire opzioni per chiamare l'API da un flusso di lavoro dopo aver completato la distribuzione e l'hosting per l'API nel servizio app.

Per altre informazioni, vedere:

Prerequisiti

Aggiungere Swagger e l'accesso CORS all'applicazione web o all'applicazione API

Quando si aggiunge un documento Swagger all'app Web o all'app per le API, la finestra di progettazione del flusso di lavoro in App per la logica di Azure può trovare e visualizzare più facilmente le operazioni e i parametri disponibili nell'API. È anche necessario configurare la condivisione di risorse tra le origini (CORS) nell'app Web o nell'app per le API in modo che il flusso di lavoro possa accedere all'API.

Per rendere leggibile il documento Swagger dal tuo flusso di lavoro nel designer, nella tua app Web o app per le API, imposta le proprietà di definizione API e l'accesso CORS.

  1. Nel portale di Azure trovare e aprire la risorsa dell'app Web o dell'app per le API.

  2. Nella barra laterale della risorsa dell'app selezionare Panoramica.

  3. Nella scheda Proprietà , in Domini, dalla proprietà Dominio predefinito copiare e salvare il nome del sito Web da qualche parte per il passaggio successivo.

  4. Nella barra laterale della risorsa dell'app, in API selezionare Definizione API. Per percorso di definizione API immettere l'URL per il file JSON Swagger, che in genere usa il formato seguente, ma potrebbe differire se il file Swagger usa una specifica API più recente:

    https://<website-name>/swagger/docs/v1

    L'esempio seguente mostra un URL Swagger con la specifica API più recente:

    Screenshot che mostra il portale di Azure, la pagina di definizione dell'API dell'app Web e l'URL per il documento Swagger dell'API.

  5. Al termine, seleziona Salva.

  6. Nella barra laterale della risorsa dell'app, in API selezionare CORS.

  7. Per Origine consentita, impostare il criterio CORS su '*', ovvero consentire tutto.

    Questa impostazione consente le richieste dall'editor del flusso di lavoro in Azure Logic Apps.

    La schermata mostra il pannello CORS dell'app Web con le origini consentite impostate su *, il che consente tutto.

  8. Sulla barra degli strumenti selezionareSave (Salva).

Per altre informazioni, vedere Ospitare un'API RESTful con CORS nel servizio app di Azure.

Chiamare l'API dal flusso di lavoro

Dopo aver configurato l'URL di definizione dell'API e CORS, le operazioni API vengono visualizzate nella raccolta di connettori per consentire all'utente di trovarle e aggiungerle al flusso di lavoro.

  • Per visualizzare i siti Web con URL OpenAPI, è possibile esplorare i siti Web di sottoscrizione nella finestra di progettazione del flusso di lavoro.

  • Per visualizzare le azioni e gli input disponibili puntando a un documento Swagger, usare il trigger o l'azione HTTP + Swagger .

  • Per chiamare qualsiasi API, incluse le API che non hanno o espongono un documento Swagger, è sempre possibile creare una richiesta con l'azione HTTP.

Contenuti correlati

  • Last updated on