Envoyer des appels sortants à des points de terminaison HTTP ou HTTPS avec Azure Logic AppsSend outgoing calls to HTTP or HTTPS endpoints by using Azure Logic Apps

Avec Azure Logic Apps et le déclencheur ou l’action HTTP intégrés, vous pouvez créer des tâches et des workflows automatisés qui envoient régulièrement des requêtes à un point de terminaison HTTP ou HTTPS quelconque.With Azure Logic Apps and the built-in HTTP trigger or action, you can create automated tasks and workflows that regularly send requests to any HTTP or HTTPS endpoint. Pour recevoir et répondre aux appels HTTP ou HTTPS entrants, utilisez le déclencheur de requête ou l’action Réponse intégrés.To receive and respond to incoming HTTP or HTTPS calls instead, use the built-in Request trigger or Response action.

Par exemple, vous pouvez surveiller le point de terminaison de service pour votre site web en vérifiant ce point de terminaison selon une planification définie.For example, you can monitor the service endpoint for your website by checking that endpoint on a specified schedule. Lorsqu’un événement se produit au niveau de ce point de terminaison, tel qu’une panne de votre site web, l’événement déclenche le flux de travail de votre application logique et exécute les actions spécifiées.When a specific event happens at that endpoint, such as your website going down, the event triggers your logic app's workflow and runs the specified actions.

Vous pouvez utiliser le déclencheur HTTP comme première étape de votre flux de travail pour vérifier ou interroger un point de terminaison selon une planification régulière.To check or poll an endpoint on a regular schedule, you can use the HTTP trigger as the first step in your workflow. À chaque vérification, le déclencheur envoie un appel ou une demande au point de terminaison.On each check, the trigger sends a call or request to the endpoint. La réponse du point de terminaison détermine si le flux de travail de votre application logique s’exécute.The endpoint's response determines whether your logic app's workflow runs. Le déclencheur transmet le contenu de la réponse aux actions de votre application logique.The trigger passes along any content from the response to the actions in your logic app.

Vous pouvez utiliser l’action HTTP comme toute autre étape de votre flux de travail pour appeler le point de terminaison quand vous le souhaitez.You can use the HTTP action as any other step in your workflow for calling the endpoint when you want. La réponse du point de terminaison détermine la façon dont s’exécutent les actions restantes de votre flux de travail.The endpoint's response determines how your workflow's remaining actions run.

En fonction des capacités du point de terminaison cible, le connecteur HTTP prend en charge les versions 1.0, 1.1 et 1.2 du protocole TLS (Transport Layer Security).Based the target endpoint's capability, the HTTP connector supports Transport Layer Security (TLS) versions 1.0, 1.1, and 1.2. Logic Apps négocie avec le point de terminaison en utilisant la version prise en charge la plus récente possible.Logic Apps negotiates with the endpoint over using the highest supported version possible. Si, par exemple, le point de terminaison prend en charge la version 1.2, le connecteur commence par utiliser celle-ci.So, for example, if the endpoint supports 1.2, the connector uses 1.2 first. Sinon, le connecteur utilise la version prise en charge juste inférieure.Otherwise, the connector uses the next highest supported version.

Conditions préalables requisesPrerequisites

Ajouter un déclencheur HTTPAdd an HTTP trigger

Ce déclencheur intégré effectue un appel HTTP vers l’URL spécifiée d’un point de terminaison et renvoie une réponse.This built-in trigger makes an HTTP call to the specified URL for an endpoint and returns a response.

  1. Connectez-vous au portail Azure.Sign in to the Azure portal. Ouvrez votre application logique vide dans le Concepteur d’application logique.Open your blank logic app in Logic App Designer.

  2. Sous Choisir une action, dans la zone de recherche, entrez « http » en guise de filtre.Under Choose an action, in the search box, enter "http" as your filter. Dans la liste Déclencheurs, sélectionnez le déclencheur HTTP.From the Triggers list, select the HTTP trigger.

    Sélectionner le déclencheur HTTP

    Cet exemple renomme le déclencheur « Déclencheur HTTP » afin que l’étape ait un nom plus descriptif.This example renames the trigger to "HTTP trigger" so that the step has a more descriptive name. En outre, il ajoute ultérieurement une action HTTP, et les deux noms doivent être uniques.Also, the example later adds an HTTP action, and both names must be unique.

  3. Indiquez les valeurs des paramètres du déclencheur HTTP à inclure dans l’appel au point de terminaison cible.Provide the values for the HTTP trigger parameters that you want to include in the call to the target endpoint. Configurez la fréquence à laquelle le déclencheur doit vérifier le point de terminaison cible.Set up the recurrence for how often you want the trigger to check the target endpoint.

    Si vous sélectionnez un type d’authentification autre que Aucun, les paramètres d’authentification varient en fonction de votre sélection.If you select an authentication type other than None, the authentication settings differ based on your selection. Pour plus d’informations, voir Ajouter l’authentification aux appels sortants.For more information, see Add authentication to outbound calls.

    Entrer les paramètres du déclencheur HTTP

  4. Pour ajouter d’autres paramètres disponibles, ouvrez la liste Ajouter un nouveau paramètre, puis sélectionnez les paramètres de votre choix.To add other available parameters, open the Add new parameter list, and select the parameters that you want.

  5. Continuez à générer le flux de travail de votre application logique avec des actions qui s’exécutent quand le déclencheur se déclenche.Continue building your logic app's workflow with actions that run when the trigger fires.

  6. Lorsque vous avez terminé, pensez à enregistrer votre application logique.When you're done, remember to save your logic app. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.On the designer toolbar, select Save.

Ajouter une action HTTPAdd an HTTP action

Cette action intégrée effectue un appel HTTP à l’URL spécifiée d’un point de terminaison et renvoie une réponse.This built-in action makes an HTTP call to the specified URL for an endpoint and returns a response.

  1. Connectez-vous au portail Azure.Sign in to the Azure portal. Ouvrez votre application logique dans le Concepteur d’applications logiques.Open your logic app in Logic App Designer.

    Cet exemple utilise le déclencheur HTTP en tant que première étape.This example uses the HTTP trigger as the first step.

  2. Sous l’étape à laquelle vous souhaitez ajouter l’action HTTP, choisissez Nouvelle étape.Under the step where you want to add the HTTP action, select New step.

    Pour ajouter une action entre des étapes, placez votre pointeur au-dessus de la flèche qui les sépare.To add an action between steps, move your pointer over the arrow between steps. Cliquez sur le signe ( + ) qui s’affiche, puis sélectionnez Ajouter une action.Select the plus sign (+) that appears, and then select Add an action.

  3. Sous Choisir une action, dans la zone de recherche, entrez « http » en guise de filtre.Under Choose an action, in the search box, enter "http" as your filter. Dans la liste Actions, sélectionnez HTTP.From the Actions list, select the HTTP action.

    Sélection de l’action HTTP

    Cet exemple renomme l’action « Action HTTP » afin qu’elle ait un nom plus descriptif.This example renames the action to "HTTP action" so that the step has a more descriptive name.

  4. Indiquez les valeurs des paramètres d’actions HTTP à inclure dans l’appel au point de terminaison cible.Provide the values for the HTTP action parameters that you want to include in the call to the target endpoint.

    Si vous sélectionnez un type d’authentification autre que Aucun, les paramètres d’authentification varient en fonction de votre sélection.If you select an authentication type other than None, the authentication settings differ based on your selection. Pour plus d’informations, voir Ajouter l’authentification aux appels sortants.For more information, see Add authentication to outbound calls.

    Entrer les paramètres de l’action HTTP

  5. Pour ajouter d’autres paramètres disponibles, ouvrez la liste Ajouter un nouveau paramètre, puis sélectionnez les paramètres de votre choix.To add other available parameters, open the Add new parameter list, and select the parameters that you want.

  6. Lorsque vous avez terminé, pensez à enregistrer votre application logique.When you're done, remember to save your logic app. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.On the designer toolbar, select Save.

Contenu avec type multipart/form-dataContent with multipart/form-data type

Pour gérer le contenu qui a le type multipart/form-data dans les requêtes HTTP, vous pouvez ajouter un objet JSON qui comprend les attributs $content-type et $multipart dans le corps de la requête HTTP à l’aide de ce format.To handle content that has multipart/form-data type in HTTP requests, you can add a JSON object that includes the $content-type and $multipart attributes to the HTTP request's body by using this format.

"body": {
   "$content-type": "multipart/form-data",
   "$multipart": [
      {
         "body": "<output-from-trigger-or-previous-action>",
         "headers": {
            "Content-Disposition": "form-data; name=file; filename=<file-name>"
         }
      }
   ]
}

Par exemple, supposons que vous ayez une application logique qui envoie une requête HTTP POST pour un fichier Excel sur un site web à l’aide de l’API de ce site, qui prend en charge le type multipart/form-data.For example, suppose you have a logic app that sends an HTTP POST request for an Excel file to a website by using that site's API, which supports the multipart/form-data type. Voici comment cette action peut se présenter :Here's how this action might look:

Données de formulaire en plusieurs parties

Voici le même exemple qui montre la définition JSON de l’action HTTP dans la définition de flux de travail sous-jacente :Here is the same example that shows the HTTP action's JSON definition in the underlying workflow definition:

{
   "HTTP_action": {
      "body": {
         "$content-type": "multipart/form-data",
         "$multipart": [
            {
               "body": "@trigger()",
               "headers": {
                  "Content-Disposition": "form-data; name=file; filename=myExcelFile.xlsx"
               }
            }
         ]
      },
      "method": "POST",
      "uri": "https://finance.contoso.com"
   },
   "runAfter": {},
   "type": "Http"
}

Référence de connecteurConnector reference

Pour en savoir plus sur les paramètres des déclencheurs et des actions, consultez les sections suivantes :For more information about trigger and action parameters, see these sections:

Détails des résultatsOutput details

Voici d’autres informations sur les sorties d’un déclencheur ou d’une action HTTP qui renvoient les données suivantes :Here is more information about the outputs from an HTTP trigger or action, which returns this information:

Nom de la propriétéProperty name TypeType DescriptionDescription
headersheaders objectobject En-têtes de la requêteThe headers from the request
bodybody objectobject Objet JSONJSON object Objet avec le contenu du corps de la requêteThe object with the body content from the request
Code d’étatstatus code intint Code d’état de la requêteThe status code from the request
Code d’étatStatus code DescriptionDescription
200200 OKOK
202202 AcceptéeAccepted
400400 Demande incorrecteBad request
401401 Non autoriséUnauthorized
403403 InterditForbidden
404404 IntrouvableNot Found
500500 Erreur interne du serveur.Internal server error. Une erreur inconnue s’est produite.Unknown error occurred.

Étapes suivantesNext steps