Introduzione all'azione HTTP + SwaggerGet started with the HTTP + Swagger action

È possibile creare un connettore di prima classe a qualsiasi endpoint REST tramite un documento di Swagger quando si usa l'azione HTTP + Swagger nel flusso di lavoro dell'app per la logica.You can create a first-class connector to any REST endpoint through a Swagger document when you use the HTTP + Swagger action in your logic app workflow. È anche possibile estendere app per la logica per chiamare qualsiasi endpoint REST con un'eccellente esperienza di progettazione delle app per la logica.You can also extend logic apps to call any REST endpoint with a first-class Logic App Designer experience.

Per informazioni su come creare app per la logica con i connettori, consultare Creare una nuova app per la logica.To learn how to create logic apps with connectors, see Create a new logic app.

Usare HTTP + Swagger come trigger o azioneUse HTTP + Swagger as a trigger or an action

Il trigger e l'azione HTTP + Swagger funzionano come l'azione HTTP, ma offrono un'esperienza migliore in Progettazione app per la logica, mostrando la forma dell'API e i risultati grazie ai metadati Swagger.The HTTP + Swagger trigger and action work the same as the HTTP action but provide a better experience in Logic App Designer by exposing the API structure and outputs from the Swagger metadata. È anche possibile usare il connettore HTTP + Swagger come trigger.You can also use the HTTP + Swagger connector as a trigger. Se si desidera implementare un trigger di poll, seguire il modello di polling descritto in Creazione di un'API personalizzata da usare con le app per la logica.If you want to implement a polling trigger, follow the polling pattern that's described in Create custom APIs to call other APIs, services, and systems from logic apps.

Altre informazioni sui trigger e le azioni nelle app per la logica.Learn more about logic app triggers and actions.

Di seguito è riportato un esempio di come usare l'operazione HTTP + Swagger come azione in un flusso di lavoro in un'app per la logica.Here's an example of how to use the HTTP + Swagger operation as an action in a workflow in a logic app.

  1. Fare clic sul pulsante Nuovo passaggio .Select the New Step button.
  2. Selezionare Aggiungi un'azione.Select Add an action.
  3. Nella casella di ricerca azione digitare swagger per elencare l'azione HTTP + Swagger.In the action search box, type swagger to list the HTTP + Swagger action.

    Selezionare l'azione HTTP + Swagger

  4. Digitare l'URL per un documento di Swagger:Type the URL for a Swagger document:

    • Per funzionare dalla finestra di progettazione app per la logica, l'URL deve essere un endpoint HTTPS e avere CORS abilitato.To work from the Logic App Designer, the URL must be an HTTPS endpoint and have CORS enabled.
    • Se il documento di Swagger non soddisfa questo requisito, è possibile usare Archiviazione di Azure con CORS abilitato per archiviare il documento.If the Swagger document doesn't meet this requirement, you can use Azure Storage with CORS enabled to store the document.
  5. Fare clic su Avanti per leggere e visualizzare il documento di Swagger.Click Next to read and render from the Swagger document.
  6. Aggiungere i parametri richiesti per la chiamata HTTP.Add in any parameters that are required for the HTTP call.

    Completare l'azione HTTP

  7. Per salvare e pubblicare un'app per la logica, fare clic su Salva nella barra degli strumenti della finestra di progettazione.To save and publish your logic app, click Save on designer toolbar.

Ospitare Swagger da Archiviazione di AzureHost Swagger from Azure Storage

Si consiglia di fare riferimento a un documento di Swagger che non sia ospitato o non soddisfi i requisiti di sicurezza e origini multiple per la finestra di progettazione.You might want to reference a Swagger document that's not hosted, or that doesn't meet the security and cross-origin requirements for the designer. Per risolvere questo problema, è possibile archiviare il documento di Swagger in Archiviazione di Azure e abilitare CORS a fare riferimento al documento.To resolve this issue, you can store the Swagger document in Azure Storage and enable CORS to reference the document.

Ecco i passaggi per creare, configurare e archiviare i documenti di Swagger in Archiviazione di Azure:Here are the steps to create, configure, and store Swagger documents in Azure Storage:

  1. Creare un account di Archiviazione di Azure con Archiviazione BLOB di Azure.Create an Azure storage account with Azure Blob storage. Per eseguire questo passaggio, impostare le autorizzazioni su Accesso pubblico.To perform this step, set permissions to Public Access.

  2. Abilitare CORS nel BLOB.Enable CORS on the blob.

    Per configurare tale impostazione automaticamente è possibile usare questo script di PowerShell.To automatically configure this setting, you can use this PowerShell script.

  3. Caricare il file di Swagger nel BLOB.Upload the Swagger file to the blob.

    È possibile eseguire questo passaggio nel portale di Azure o con uno strumento come Esplora archivi di Azure.You can perform this step from the Azure portal or from a tool like Azure Storage Explorer.

  4. Rimandare un collegamento HTTPS al documento nell'archiviazione BLOB di AzureReference an HTTPS link to the document in Azure Blob storage.

    Il collegamento usa questo formato:The link uses this format:

    https://*storageAccountName*.blob.core.windows.net/*container*/*filename*

Dettagli tecniciTechnical details

Di seguito sono riportati i dettagli per i trigger e le azioni supportati da questo connettore HTTP + Swagger.Following are the details for the triggers and actions that this HTTP + Swagger connector supports.

Trigger HTTP + SwaggerHTTP + Swagger triggers

Un trigger è un evento che può essere usato per avviare il flusso di lavoro definito in un'app per la logica.A trigger is an event that can be used to start the workflow that's defined in a logic app. Altre informazioni sui trigger.Learn more about triggers. Il connettore HTTP + Swagger supporta un solo trigger.The HTTP + Swagger connector has one trigger.

TriggerTrigger DescrizioneDescription
HTTP + SwaggerHTTP + Swagger Esegue una chiamata HTTP e restituisce il contenuto della rispostaMake an HTTP call and return the response content

Azioni HTTP + SwaggerHTTP + Swagger actions

Un'azione è un'operazione eseguita dal flusso di lavoro e definita in un'app per la logica.An action is an operation that's carried out by the workflow that's defined in a logic app. Ulteriori informazioni sulle azioni.Learn more about actions. Il connettore HTTP + Swagger supporta una sola azione possibile.The HTTP + Swagger connector has one possible action.

AzioneAction DescrizioneDescription
HTTP + SwaggerHTTP + Swagger Esegue una chiamata HTTP e restituisce il contenuto della rispostaMake an HTTP call and return the response content

Informazioni dettagliate sulle azioniAction details

Il connettore HTTP + Swagger include una sola azione possibile.The HTTP + Swagger connector comes with one possible action. Di seguito sono riportate le informazioni su ognuna delle azioni, i relativi campi di input obbligatori e facoltativi e i corrispondenti dettagli di output associati al loro uso.Following is information about each of the actions, their required and optional input fields, and the corresponding output details that are associated with their usage.

HTTP + SwaggerHTTP + Swagger

Eseguire una richiesta HTTP in uscita con l'assistenza dei metadati Swagger.Make an HTTP outbound request with assistance of Swagger metadata. L'asterisco () indica un campo obbligatorio.An asterisk () means a required field.

Nome visualizzatoDisplay name Nome proprietàProperty name DescrizioneDescription
MetodoMethod staticomethod Verbo HTTP da usare.HTTP verb to use.
URIURI Uriuri URI per la richiesta HTTP.URI for the HTTP request.
HeadersHeaders Headersheaders Un oggetto JSON delle intestazioni HTTP da includere.A JSON object of HTTP headers to include.
CorpoBody Corpobody Il corpo della richiesta HTTP.The HTTP request body.
AutenticazioneAuthentication Autenticazioneauthentication Autenticazione da usare per la richiesta.Authentication to use for request. Per altre informazioni, vedere il connettore HTTP.For more information, see the HTTP connector.

Dettagli dell'outputOutput details

Risposta HTTPHTTP response

Nome proprietàProperty Name Tipo di datiData type DescrizioneDescription
headersHeaders objectobject Intestazioni della rispostaResponse headers
CorpoBody objectobject Oggetto della rispostaResponse object
Codice di statoStatus Code intint Stato codice HTTPHTTP status code

Risposte HTTPHTTP responses

Quando si eseguono chiamate a varie azioni, è possibile ottenere determinate risposte.When making calls to various actions, you might get certain responses. Di seguito è riportata una tabella contenente le risposte e le descrizioni corrispondenti.Following is a table that outlines corresponding responses and descriptions.

NomeName DescrizioneDescription
200200 OKOK
202202 AcceptedAccepted
400400 Richiesta non validaBad request
401401 Non autorizzataUnauthorized
403403 Accesso negatoForbidden
404404 Non trovatoNot Found
500500 Errore interno del server.Internal server error. Si è verificato un errore sconosciuto.Unknown error occurred.

Passaggi successiviNext steps