Distribuire e chiamare API personalizzate da flussi di lavoro in App per la logica
Si applica a: App per la logica di Azure (consumo)
Dopo aver creato API personalizzate da usare nei flussi di lavoro di app per la logica, perché sia possibile chiamarle è necessario distribuirle. È possibile distribuire le API come app Web, ma è consigliabile distribuirle come app per le API, in modo da semplificare le attività durante la compilazione, l'hosting e l'uso delle API nel cloud e in locale. Non è necessario modificare alcuna parte di codice nelle API, ma è sufficiente distribuire il codice in un'app per le API. È possibile ospitare le API in Servizio app di Azure, una soluzione PaaS (Platform-as-a-Service, piattaforma distribuita come servizio) che offre hosting di API semplice e altamente scalabile.
Sebbene sia possibile chiamare qualsiasi API da un flusso di lavoro dell'app per la logica, per un'esperienza ottimale, aggiungere metadati Swagger che descrivono le operazioni e i parametri dell'API. Questo documento di Swagger consente all'API di integrarsi più facilmente e di lavorare meglio con i flussi di lavoro dell'app per la logica.
Distribuire l'API come app Web o app per le API
Prima di poter chiamare l'API personalizzata da un flusso di lavoro dell'app per la logica, distribuire l'API come app Web o app per le API in Servizio app di Azure. Per rendere leggibile il documento Swagger dal flusso di lavoro, impostare le proprietà di definizione dell'API e attivare la condivisione di risorse tra le origini (CORS) per l'app Web o l'app per le API.
Nel portale di Azure selezionare l'app Web o l'app per le API.
Nel menu dell'app visualizzato in API selezionare Definizione API. Impostare la posizione della definizione dell'API sull'URL del file swagger.json.
In genere, l'URL viene visualizzato in questo formato:
https://{name}.azurewebsites.net/swagger/docs/v1)
In API selezionare CORS. Impostare i criteri CORS per Origini consentite"*" (consenti tutto).
Questa impostazione consente le richieste dalla finestra di progettazione del flusso di lavoro.
Per altre informazioni, vedere Ospitare un'API RESTful con CORS in Servizio app di Azure.
Chiamare l'API personalizzata dai flussi di lavoro delle app per la logica
Dopo aver configurato le proprietà di definizione dell'API e CORS, i trigger e le azioni dell'API personalizzata saranno disponibili per l'inserimento nel flusso di lavoro delle app per la logica.
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 di Swagger, usare l'azione HTTP + Swagger.
Per chiamare qualsiasi API, incluse le API che non hanno o non espongono un documento Swagger, è sempre possibile creare una richiesta con l'azione HTTP.