Envoyer une requête HTTP
L'actionEnvoyer une requête HTTPconnecte votre flux de travail à un serveur web ou à une URL et envoie des requêtes HTTP.
Une fois que Flow a envoyé votre requête HTTP, lecode de réponse HTTPsera envoyé sous 30 secondes au maximum. Si Flow n’a pas reçu de réponse au bout de 30 secondes, il ferme la connexion à votre application et renvoie la requête.
Sur cette page
Champs
L’actionEnvoyer une requête HTTPcontient les champs suivants.
| Champ | Description |
|---|---|
| Protocole HTTP | La méthode de requête HTTP à envoyer. L’actionEnvoyer une requête HTTPprend en charge les méthodes suivantes :
|
| URL | L’URL du serveur vers lequel la requête HTTP est envoyée. |
| En-têtes | La clé et la paire de valeur pour la requête HTTP. Il est possible de saisie de plusieurs paires clé-valeur. |
| message | Le contenu à envoyer au serveur. |
Déclencheurs
L’actionEnvoyer une requête HTTPpeut être utilisée dans n’importe quel flux de travail.
Exemples
Appeler l’API Admin Shopify GraphQL
Dans cet exemple, vous utiliserez Flow pour modifier le titre d’un produit en appelant l’APIproductUpdate.
Avant de commencer, faites ce qui suit :
- Configurez et installez une application personnaliséedisposant de la portée
write_products. Dans cet exemple, vous utiliserez laclé secrète de l’APIpour appeler l’API.
Ensuite, suivez les étapes ci-après dans Flow :
- Choisissez le déclencheurmis à jour du statut du produit, qui vous permet de tester ce flux de travail en changeant le statut d’un produit.
- Ajoutez l’actionEnvoyer une requête HTTPà votre flux de travail et connectez-la au déclencheur.
- Ouvrez le panneau de configuration en cliquant sur l’étapeEnvoyer une requête HTTP.
- Dans le champProtocole HTTP, saisissez
POST. - Dans le champURL, saisissez
https://admin.shopify.com/store/shopname/api/2023-01/graphql.jsonen remplaçant le nom de domaine de votre boutique et la version d’API souhaitée. - Dans la sectionEn-têtes, saisissez unecléde
X-Shopify-Access-Tokenet unevaleurdeYOUR_API_SECRET_KEYque vous avez obtenues à la première étape. - Dans la sectionEn-têtes, saisissez un deuxième en-tête avec unecléde
Content-Typeet unevaleurdeapplication/json. - Dans la sectionCorps, saisissez ce qui suit :
json {"query": "mutation { productUpdate(input: {id: \"{{ product.id }}\", title: \"{{product.title}}-edited\"}) { product { id } } }"}
- Ce code ajoute
-editedà la fin de votre titre. - Les espaces et les nouvelles lignes sont signifiants pour l’éditeur Liquid. Évitez donc d’ajouter ou de supprimer des espaces. Par ailleurs, évitez les accolades comme
{{et}}(除非倒les架次液体)、汽车它们ont réservées aux variables Liquid.
- Configurez le reste du flux de travail et activez-le.
- Testez-le en faisant passer le statut d’un produit d’ÉbaucheàActifou vice versa.
Appeler une API externe
Dans cet exemple de flux de travail, une requête POST HTTP est envoyée à un serveur lorsqu’une commande est payée.
Codes de réponse
Le tableau suivant décrit comment Flow traite leCode de réponse HTTPaprès avoir reçu une réponse.
| Code de réponse HTTP | Comment Flow traite le code de réponse |
|---|---|
| Succès 2XX ou 3XX | Flow marque la requête HTTP comme un succès et effectue des actions ultérieures dans le flux de travail. |
| Erreur 429 ou 5XX | Le flux tente automatiquement l'action pendant un maximum de 24 heures jusqu'à ce qu'il reçoive un code de réponse différent ou qu'il s'arrête. |
| Autre code de réponse | Si votre application renvoie un code qui n'est pas décrit dans ce tableau ou si elle s'arrête pendant qu'elle tente à nouveau des actions, Flow considère que la requête HTTP a échoué. Les actions ultérieures du flux de travail ne sont pas exécutées. |