HTTP-Anfrage senden

Hinweis

Diese Aktion ist nur für Folgendes verfügbar:

• Shops, die den Plan Shopify Plus, Advanced oder Shopify abonniert haben

Die Aktion HTTP-Anfrage senden verbindet deinen Workflow mit einem Webserver oder einer URL und sendet HTTP-Anfragen.

Nachdem Flow deine HTTP-Anfrage gesendet hat, wartet das Tool maximal 30 Sekunden auf einen HTTP-Antwortcode. Falls Flow nach 30 Sekunden keine Antwort von deiner App erhalten hat, wird die Verbindung zu deiner App abgebrochen und die Anfrage erneut gesendet.

Felder

Die Aktion HTTP-Anfrage senden enthält die folgenden Felder.

Felder, die in der Aktion "HTTP-Anfrage senden" verwendet werden.

Feld	Beschreibung
HTTP-Methode	Die Methode zum Senden der HTTP-Anfrage. Die Aktion HTTP-Anfrage senden unterstützt die folgenden Methoden: Get – Fordert Informationen vom Server an. Delete – Entfernt eine Ressource vom Server. Head - Ruft die HTTP-Antwortheader des Servers ab. Optionen – Ruft die Optionen und Funktionen ab, die vom Server unterstützt werden. Patch – Aktualisiert Teile einer Ressource auf dem Server. Put – Aktualisiert eine Ressource auf dem Server. Post – Erstellt oder ersetzt eine Ressource auf dem Server.
URL	Die URL des Servers, an den die HTTP-Anfrage gesendet wird.
Header	Das Schlüssel-Wert-Paar für die HTTP-Anfrage. Es können mehrere Schlüssel-Wert-Paare eingegeben werden.
Nachricht	Der Inhalt, der an den Server gesendet werden soll.

Trigger

Die Aktion HTTP-Anfrage senden kann in jedem Workflow verwendet werden.

Beispiele

Shopify GraphQL Admin API aufrufen

In diesem Beispiel verwendest du Flow, um einen Produkttitel zu bearbeiten, indem du die productUpdate-API aufrufst.

Bevor du beginnst, führe die folgenden Schritte aus:

• Eine benutzerdefinierte App einrichten und installieren, die den Bereich write_products hat. Du verwendest den Geheimen API-Schlüssel, um die API in diesem Beispiel aufzurufen.

Folge dann diesen Schritten in Flow:

1. Wähle den Trigger Produktstatus aktualisiert aus, mit dem du diesen Workflow testen kannst, indem du den Status eines Produkts änderst.
2. Füge HTTP-Anfrage senden zu deinem Workflow hinzu und verbinde ihn mit dem Trigger.
3. Öffne das Konfigurationsfenster, indem du auf den Schritt HTTP-Anfrage senden klickst.
4. Gib im Feld HTTP-Methode POST ein.
5. Gib im Feld URL https://admin.shopify.com/store/shopname/api/2023-01/graphql.json ein, um deine Shop-Domain und die gewünschte API-Version anzugeben.
6. Gib im Abschnitt Header einen Schlüssel X-Shopify-Access-Token und den Wert YOUR_API_SECRET_KEY ein, den du im ersten Schritt erhalten hast.
7. Gib im Abschnitt Header eine zweite Kopfzeile mit dem Schlüssel Content-Type und dem Wert application/json ein.
8. Gib im Abschnitt Text Folgendes ein:

json {"query": "mutation { productUpdate(input: {id: \"{{ product.id }}\", title: \"{{product.title}}-edited\"}) { product { id } } }"}

• Dieser Code fügt -edited am Ende deines Titels hinzu
• Leerzeichen und neue Zeilen sind für den Liquid-Editor sinnvoll. Daher solltest du vermeiden, Leerzeichen hinzuzufügen oder zu entfernen. Vermeide außerdem, außer bei der Ausgabe von Liquid, geschweifte Klammern wie {{ und }}, da sie für Liquid-Variablen reserviert sind.

1. Konfiguriere den Rest des Workflows und aktiviere ihn.
2. Teste ihn, indem du den Status eines Produkts von Entwurf in Aktiv änderst oder umgekehrt.

Eine externe API aufrufen

In diesem Beispiel-Workflow wird beim Bezahlen einer Bestellung eine POST-HTTP-Anfrage an einen Server gesendet.

Antwortcodes

In der folgenden Tabelle wird beschrieben, wie Flow den HTTP-Antwortcode verarbeitet, nachdem das Programm eine Antwort erhalten hat.

Verarbeitung von HTTP-Antwortcodes durch Flow.

HTTP-Antwortcode	So verarbeitet Flow den Antwortcode
2XX oder 3XX – Erfolgreiche Operation	Flow markiert die HTTP-Anfrage als erfolgreiche Operation und führt alle nachfolgenden Aktionen im Workflow aus.
429 oder 5XX – Fehler	Flow wiederholt die Aktion automatisch bis zu 24 Stunden lang, bis die Plattform einen anderen Antwortcode empfängt oder die Anfrage abläuft.
Anderer Antwortcode	Wenn deine App einen anderen Code als die hier aufgeführten zurückgibt oder die Anfrage beim Wiederholen von Aktionen abläuft, markiert Flow die HTTP-Anfrage als fehlgeschlagen. Nachfolgende Workflow-Aktionen werden nicht durchgeführt.