1. All Collections >
  2. Produkt >
  3. Workflows >
  4. Schritt: HTTP-Anfrage

Schritt: HTTP-Anfrage

Avatar
Shing-Yi Tan
4 Min. Lesezeit

Dieser Schritt ermöglicht das Senden von HTTP-Anfragen und das Speichern ihrer Antworten als Variablen.

Dieser Schritt ist nur ab dem Advanced-Plan verfügbar.

Konfiguration

Im HTTP-Anforderungsschritt gibt es zwei wichtige Konfigurationen:

HTTP-Anforderungsmethode

Die für die Anforderung erforderliche spezifische Methode. Wählen Sie die entsprechende Methode aus der Dropdown-Liste.

URL

Geben Sie im URL-Feld den URL-Endpunkt der externen API ein, um Daten abzurufen. Um Variablen einzuschließen, verwenden Sie das Präfix "$" , um die Interpolation von statischem Text und Variablen zu unterstützen.

Sie können jetzt im HTTP-Anforderungsschritt IP-Adressen und Portnummern verwenden, wodurch Sie direkten Zugriff auf Server und die Flexibilität haben, auf Dienste auf nicht standardmäßigen Ports zuzugreifen.

Bitte beachte, dass die Domain respond.io auf der schwarzen Liste steht. Das Senden eines API-Aufrufs an diese Domain ist nicht erlaubt, da dies zu Endlosschleifen führen könnte.

Körper

Um eine korrekte Dekodierung durch den Anforderungsempfänger sicherzustellen, erweitern Sie den Abschnitt „Body“ und fügen Sie zusammen mit dem Content-Type-Header einen Body ein.

Kopfzeilen

Im Bereich „Header“ können Sie der HTTP-Anfrage paarweise Header hinzufügen. Der Schlüssel stellt den Header-Namen dar und der Wert stellt den Header-Wert dar. Sie können Variablen als Überschriften verwenden, indem Sie das Präfix "$"hinzufügen. Beachte jedoch, dass maximal 10 Überschriften zulässig sind.

Antwortzuordnung

Bei JSON-API-Antworten kannst du bestimmte Antwortwerte als Variablen speichern. Gib im Abschnitt „Antwortzuordnung“ links den JSON-Pfad/die Referenz zum Wert ein und weise rechts einen Variablennamen zu.

Im Feld "JSON Key" muss der JSON-Pfad/die Referenz zu dem Wert stehen, den du speichern möchtest, beginnend am Root der Antwort mit `$`. Zum Beispiel, für `{"phone":"123123"}`, gib `$.phone` ein, nicht `phone`.

Beispiele:

Um Werte aus verschiedenen Antwortformaten zu speichern, fülle das Feld "JSON Key" mit dem JSON-Pfad zu den Daten aus, die du speichern möchtest.

{  
    "Name": "Jason",  
    "Postleitzahlen": "12345",  
    "Telefon": "123123"  
}

Um die Telefonnummer aus der obigen Antwort zu speichern, gib $.phone in das Feld "JSON Key" ein.

{ 
    "benutzerdefinierte Felder": {  
        "Vorname": "John",  
        "Nachname": "Doe",  
        "Gebietsschema": "en_GB",  
        "Zeitzone": "5",  
        "Geschlecht": "männlich",  
        "Telefon": "123123",  
        "E-Mail": "zy@respond.io",  
        "Kunden-ID": "1"  
    },  
    "erstellt am": 1575618542  
}

Um die Telefonnummer aus der obigen Antwort zu speichern, gib $.custom_fields.phone in das Feld "JSON Key" ein.

{  
        "data": {  
            "id":"1776025372480910",  
            "contacts" : [  
                {  
                    "firstName":"John",  
                    "lastName":"Doe",  
		    "locale": "en_GB"  
                },  
                {  
                    "firstName":"Jane",  
                    "lastName":"Doe",  
		    "locale": "en_GB"  
                }  
	    ]  
        }  
    }

Um den Vornamen 'Jane' aus der obigen Antwort zu speichern, gib $.data.contacts[1].firstName in das Feld "JSON Key" ein.

Antwortstatus als Variable speichern

Um den Antwortstatus der HTTP-Anfrage als Variable zu speichern, schalten Sie den Schalter Antwortstatus als Variable speichern EIN. Benennen Sie dann die Variable im bereitgestellten Feld.

Wie es funktioniert

Wenn dieser Schritt aktiviert ist, wird unter Verwendung des definierten Textkörpers und Headers eine HTTP-Anfrage an die angegebene URL gesendet.

Sie können den Workflow anhand des Antwortstatus steuern. Du kannst beispielsweise eine Verzweigung erstellen, bei der der Statuscode "200" ist. Wenn ein anderer Antwortstatuscode empfangen wird, könnte ein Sprungschritt Kontakte an den HTTP-Anforderungsschritt zurückgeben. Alternativ könnte der Kontakt an den Fehlerzweig weitergeleitet werden, wenn die Zweigbedingungen nicht erfüllt sind. Wenn unter dem Fehlerzweig keine Schritte eingerichtet sind, wird der Workflow abgeschlossen.

Wenn Ihre HTTP-Anfrage länger als 10 Sekunden dauert, kommt es zu einer Zeitüberschreitung und die Anfrage schlägt fehl.

Möglicher Fehler

Um mögliche Fehler bei der Ausführung von HTTP-Anfragen zu vermeiden, stellen Sie sicher, dass die folgenden Bedingungen erfüllt sind:

  • Verwenden Sie die richtige HTTP-Methode und den richtigen Content-Type-Header.

  • Stellen Sie sicher, dass Sie das erforderliche Protokoll http:// oder https:// in Ihre URL aufnehmen, je nachdem, was Ihr System unterstützt, um Anforderungsfehler zu vermeiden.

  • Stellen Sie sicher, dass der Inhaltstyp gültig ist.

  • Schließen Sie die Portnummer aus der URL aus.

  • Vermeiden Sie die Verwendung eines selbstsignierten Zertifikats in der URL.

  • Überprüfen Sie, ob die Autorisierung gültig ist.

  • Stellen Sie sicher, dass unsere IP-Adressen (52.74.35.155, 18.138.31.163, 54.169.155.20) nicht blockiert sind.

Wenn eine der oben genannten Bedingungen nicht erfüllt ist, überspringt der Kontakt diesen Schritt und setzt die restliche Reise fort.

Denken Sie beim Überprüfen der HTTP-Anforderungsausgaben mit dynamischen Variablen daran, dass Variablen ohne Wert als null und undefiniertzurückgegeben werden.

Bewährte Methoden

Hier sind einige Best Practices für diesen Schritt, die Sie befolgen können, um Ihren Arbeitsablauf zu optimieren:

Wenn die HTTP-Anforderung erfolgreich ist

  1. Antwortstatus als Variable speichern:

    1. Stelle sicher, dass der erste Schritt darin besteht, den Antwortstatus als Variable zu speichern für weitere Aktionen.

  2. Verzweigungsschritt:

    1. Fügen Sie einen Verzweigungsschritt hinzu, um den Status der HTTP-Anforderung auszuwerten.

    2. Wenn der Status 200 ist, ist die Anfrage erfolgreich.

    3. Wenn nicht, konfigurieren Sie eine Warnung, um den Manager über die erfolglose Anfrage zu benachrichtigen.

  3. Google Sheetzur Überwachung:

    1. Zeichnen Sie den Antwortstatus in einem Google Sheet auf, um den Erfolg oder Misserfolg von Anfragen klar ersichtlich zu machen.

  4. Kommentar:

    1. Fügen Sie Ihrem Workflow einen Kommentar hinzu, um den Antwortstatus zu dokumentieren. Auf diese Weise können Sie Fehler effizienter verfolgen und überprüfen.

Wenn die HTTP-Anforderung fehlschlägt

  1. Antwortstatus als Variable speichern:

    1. Wie bei der erfolgreichen Anfrage, speichere den Antwortstatus als Variable zur Fehlerbehandlung.

  2. Warte- oder Sprungschritt für Wiederholungsversuche verwenden:

    1. Implementieren Sie den Warteschritt, um vor dem erneuten Versuch einer erfolglosen Anfrage eine Pause einzulegen.

    2. Alternativ können Sie mit dem Sprungschritt zum HTTP-Anforderungsschritt zurückkehren und die Anforderung erneut versuchen.

  3. Kommentar:

    1. Dokumentieren Sie den Fehler, indem Sie einen Kommentar erstellen, um den HTTP-Anforderungsfehler aufzuzeichnen

    2. Geben Sie Kontaktdaten an und markieren Sie die verantwortliche Person.

  4. Google Sheet zur Überwachung:

    1. Nutzen Sie den Google Sheet-Schritt, um die Kontaktinformationen und Fehlerdetails zur Überwachung und Überprüfung zu protokollieren.

  5. Aufgabenzuweisung:

    1. Weisen Sie die Aufgabe einem bestimmten Benutzer zu, um einen anderen Prozess innerhalb des Workflows zu starten, und versuchen Sie es erneut.

Vorgeschlagene Anwendungsfälle

Hier sind einige Möglichkeiten, wie Sie den HTTP-Anforderungsschritt verwenden können:

  • VIP-Kontakte weiterleiten: Nutze den HTTP Request Step, um Kontaktdetails aus einem Data Warehouse wie einem CRM abzurufen. Auf diese Weise können Sie VIP-Kontakte identifizieren, ein personalisiertes Kundenerlebnis ermöglichen und sie von Nicht-VIP-Kontakten unterscheiden.

FAQ und Fehlerbehebung

Kann ich einen API-Endpunkt aufrufen, der OAuth 2.0-Authentifizierung erfordert?

Nein. HTTP Request unterstützt keine OAuth 2.0-Authentifizierungsabläufe wie Benutzerzustimmung, Austausch von Autorisierungscodes, Aktualisierung von Zugriffstoken oder dynamische Token-Generierung.

Du kannst HTTP Request mit Endpunkten verwenden, die einfache Authentifizierungsmethoden akzeptieren, wie API-Keys oder statische Tokens, die zur URL, zu Query-Parametern oder zu Headern hinzugefügt werden.

Wenn du beispielsweise einen Google-API-Endpunkt aufrufst und die Anfrage fehlschlägt, prüfe, ob dieser Endpunkt OAuth 2.0-Authentifizierung erfordert. Wenn ja, wird das nicht unterstützt. Wenn der Endpunkt stattdessen API-Keys oder statische Tokens unterstützt, kannst du diese Authentifizierungsmethode in der Konfiguration von HTTP Request verwenden.

Diesen Artikel teilen
Telegram
Facebook
Linkedin
Twitter

Sie können nicht finden, was Sie suchen? 🔎