Wenn Sie den Integration Builder verwenden, können Sie Anfrageparameter vom Typ Zeichenfolge, Zahl, Boolescher Wert und Array im API-Anfragetext übergeben. Diese Funktion ermöglicht besonders flexible API-Integrationen und unterstützt eine breitere Palette von Anwendungsfällen. In diesem Beitrag erfahren Sie, wie Sie diese Parameter konfigurieren.
In diesem Beitrag werden folgende Themen behandelt:
- Festlegen des Paramertyps in Anfrageparametern
- Hinzufügen der Neuformatierung für Array-Parameter
- Verwenden von Parametern im Text des API-Aufrufs
- Testen der Konfiguration
Verwandte Beiträge:
Festlegen des Paramertyps in Anfrageparametern
So legen Sie den Parametertyp in Anfrageparametern fest
- Navigieren Sie im Integration Builder zum Abschnitt Anfrageparameter.
- Definieren Sie den Anfrageparameter und setzen Sie ihn auf einen der folgenden Typen:
- Zeichenfolge: Für Textdaten in Anführungszeichen (z. B. "Beispieltext")
- Nummer: Für numerische Werte (z. B. 123)
- Boolescher Wert: Für Wahr/Falsch-Werte
-
Array: Für eine Sammlung von Werten (z. B. ["item1", "item2"])
Hinzufügen der Neuformatierung für Array-Parameter
Zum Testen von Parametern des Typs „Array“ im Integration Builder müssen Sie eine Funktion zur Neuformatierung hinzufügen, damit der Datentyp korrekt verarbeitet wird. Verwenden Sie hierzu die folgende Funktion:
$eval($)
Diese Funktion liest den Zeichenfolgenwert in ein Array-Objekt ein.
Wenn es sich bei dem Parameter bereits um ein Array-Objekt handelt, ändert die Funktion sein Verhalten nicht.
Weitere Informationen finden Sie unter Neuformatieren von Werten in Anfrageparametern für AI Agents.
Verwenden von Parametern im Text des API-Aufrufs
Im Text des API-Aufrufs können diese Parameter im selben Format verwendet werden wie Zeichenfolgenparameter. Verwenden Sie hierzu die Syntax {{<REQUEST_PARAMETER>}}.
Dieser Parameter kann im Anfragetext wie eine Zeichenfolge aussehen (siehe Screenshot unten), wird bei der Ausführung jedoch in den im Abschnitt „Anfrageparameter“ angegebenen Datentyp transformiert.
Testen der Konfiguration
Klicken Sie im Integration Builder auf die Schaltfläche „Produktion testen“, um den API-Aufruf auszuführen.
Vergewissern Sie sich, dass die Parameter in der Anfrage jeweils mit dem korrekten Typ (Zeichenfolge, Zahl, Boolescher Wert, Array) übergeben werden.
Überprüfen Sie die Antwort, um sicherzustellen, dass sie von der API ordnungsgemäß verarbeitet wird.