Wenn Sie eine Aktion manuell hinzufügen, müssen Sie die Aktionsdetails konfigurieren, indem Sie den Pfad und die Abfrageparameter, Header, Abfragen und Antworten hinzufügen.

Wenn Sie die API-Definition importieren, müssen Sie die Aktionsdetails überprüfen und bearbeiten, um sicherzustellen, dass die Aktion die richtigen Werte für Ihre Anforderungen hat. Diese Details werden im Bot editor oder API Taskn-Editor angezeigt, wenn Sie das Paket verwenden. Wenn Sie eine Aktion hinzufügen, wird die Aktionen-Konfigurationsseite angezeigt. Die Registerkarte Konfiguration zeigt verschiedene Konfigurationseinstellungen an und die Registerkarte Test ermöglicht es Ihnen, die Aktion zu testen. Die folgenden Einstellungen sind in der Registerkarte Konfiguration verfügbar.

Einstellungen auf der Registerkarte Konfiguration

HTTP-Methode
Geben Sie den Typ der REST-Anfrage an, den Sie an den REST API-Server senden müssen. Die folgenden HTTP-Methoden werden unterstützt:
  • GET
  • PUT
  • POST
  • DELETE
  • PATCH
Anmerkung: Wenn Sie eine API-Definition importieren, ignoriert der Connector-Editor Aktionen mit nicht unterstützten Methoden und nimmt den Rest in den benutzerdefinierten Connector auf.
Endpunkt
Geben Sie die Endpunkt-URL ein, die Sie für diese Aktion verwenden. Der Paketnutzer kann diese URL nicht sehen. Verwenden Sie geschweifte Klammern {}, um den Pfad und die Abfrageparameter in der URL einzuschließen. Zum Beispiel: /{version}/product/{productid}?status={productStatus}.
Vollständige URL
Dieses schreibgeschützte Feld zeigt das automatisch generierte Feld an, das die von Ihnen beim Erstellen des Pakets eingegebene Basis-URL und die Endpunkt-URL aus dem Feld Endpunkt kombiniert. Diese URL ist für den Paketnutzer nicht sichtbar.
Anforderungsparameter
Mit Anforderungsparametern können Sie die Antworten des API-Servers identifizieren, sortieren und filtern. Verwenden Sie die Option Parameter hinzufügen, um Anforderungsparameter hinzuzufügen. Sie können Pfad- und Abfrageparameter hinzufügen. Achten Sie darauf, dass die Parameter mit dem Endpunkt-URL-Pfad übereinstimmen. Weitere Informationen zum Hinzufügen von Anforderungsparameter finden Sie unter Anforderungsparameter.
Anforderungsheader
Anforderungsheader ermöglichen es Ihnen, zusätzliche Informationen zur Anforderung hinzuzufügen. Sie können Anforderungsheader wie Accept, Content-Length, Content-Type und Cookie hinzufügen. Weitere Informationen zum Hinzufügen von Anforderungsheadern finden Sie unter Anforderungsheader.
Anforderungstext
Mit dem Abschnitt „Anforderungstext“ können Sie eine Beispiel-Nutzlast importieren, um die Struktur des Anforderungstexts zu definieren. Die Nutzlast sind die tatsächlichen Daten, die benötigt werden, um eine Ressource auf dem API-Server zu erstellen, zu aktualisieren oder zu löschen. Wenn die Aktion ausgeführt wird, enthält die Anforderung diese Nutzlast. Weitere Informationen zum Hinzufügen eines Anforderungstexts finden Sie unter Anforderungstext.
Die folgenden Optionen sind verfügbar:
  • JSON: Wählen Sie diese Option, um ein JSON-Beispiel zu importieren, um die Attribute des Anforderungstexts zuzuordnen. Blattknoten werden hier erfasst und als Liste von Attributen angezeigt. JSON bietet Flexibilität durch seine Struktur aus Schlüssel-Wert-Paaren. Weitere Informationen zur JSON-Option im Anforderungstext finden Sie unter JSON.
  • Formulardaten: Wählen Sie diese Option, um Formulardatenparameter als Attribute des Anforderungstexts hinzuzufügen. Die Option Formulardaten ist nützlich, um Dateien auf den REST API-Server hochzuladen, indem der Inhaltstyp angegeben wird. Weitere Informationen zur Option „Formulardaten“ finden Sie unter Formulardaten.
  • Formular-URL-codierte Daten Wählen Sie diese Option, um Anforderungstext-Parameter im HTML-Formular als URL-codierte Schlüssel-Wert-Paare hinzuzufügen, ähnlich wie die Abfragetyp-Anforderungsparameter. Für weitere Informationen über Formular-URL-codierte Daten codierte Daten siehe Formular-URL-codierte Daten
Antwort
Mit der Option „Antwort“ können Sie eine Beispiel-Nutzlast aus der Antwort importieren und die Attribute auszuwählen, die Sie im Bot editor und API Taskn-Editor anzeigen möchten. Weitere Informationen zum Hinzufügen eines Antwortparameters finden Sie unter Antwort