Aktivität „HTTP Request“.

Überblick

Mit der Aktivität HTTP Request können Sie HTTP-Anforderungen an eine angegebene API ausführen, indem Sie die vorhandene Connector- und Verbindungskonfiguration verwenden.

Warum sollte „HTTP Request“ gegenüber anderen Aktivitäten für einen bestimmten Connector ausgewählt werden?

Mit HTTP Request können Sie Anforderungen an jeden Endpunkt der API eines Anbieters stellen und auf deren volle Funktionen zugreifen. Das bedeutet, dass Sie jetzt über die Funktionen vordefinierter Aktivitäten hinausgehen können, die ein Integration Service-Connector bietet.

Hinweis: Die Aktivität HTTP Request ist jetzt nur für einen Teil der Integration Service-Connectors verfügbar. Sie wird in Kürze auf jeden anderen Connector erweitert, der JSON unterstützt. Überprüfen Sie die Versionshinweise der einzelnen Aktivitätspakete, um zu erfahren, wann die Aktivität für einen bestimmten Connector aktiviert ist. Sie ist auch standardmäßig für jeden benutzerdefinierten Connector verfügbar, der mit Connector Builder erstellt wird.

Einschränkungen

• Connectors, die auf SOAP-APIs oder SDKs basieren, unterstützen diese Aktivität nicht.
• Datei-Download- oder -Upload-Aktionen werden derzeit nicht unterstützt.
• Diese Aktivität verwendet derzeit nur application/json als Inhaltstyp.

Projektkompatibilität

HTTP Request-Aktivitäten sind in Studio Web- und in Studio Desktop-Windows- und plattformübergreifenden Projekten verfügbar.

Konfiguration

• Verbindungs-ID – die im Integration Service hergestellte Verbindung. Greifen Sie auf das Dropdownmenü zu, um Verbindungen auszuwählen, hinzuzufügen oder zu verwalten. Diese Verbindung ist mit den anderen Aktivitäten auf diesem Connector identisch
• Methode - Die zu verwendende Anfragemethode, wenn die API aufgerufen wird. Die folgenden HTTP-Verben werden unterstützt:
  • GET – Methode, mit der Daten von einer angegebenen Ressource angefordert werden.
  • DELETE – Die Methode, mit der Daten aus einer angegebenen Ressource gelöscht werden.
  • PATCH - Methode zum Anwenden von teilweisen Änderungen auf eine Ressource.
  • POST – Methode zum Senden von Daten an den Server.
  • PUT – Methode zum Senden von Daten an den Server, um eine Ressource zu aktualisieren.
• Basis-URL – Gibt die Basis-URL für die Anforderung an. Dies ist schreibgeschützt und wird vom Connector bereitgestellt. Wenn Ihr Endpunkt eine andere Basis-URL/einen anderen Pfad erfordert, handelt es sich wahrscheinlich um eine Änderungsanforderung oder eine benutzerdefinierte HTTP-Anforderung über das Webaktivitätspaket.
• Endpunkt – Gibt den Endpunktpfad für die Anforderung an. Dieses Feld wird mit dem schreibgeschützten Feld Basis-URL verkettet.
• Header – Die Header der Anforderung. Verwenden Sie den Wörterbuch-Editor, um Header hinzuzufügen. Die Standardheader, die der Connector an den Anbieter sendet, werden bereits im Informationsfeld angezeigt. Mit diesem Header-Wörterbuch können Sie zusätzliche Header hinzufügen.
• Abfrageparameter – Die Abfrageparameter. Verwenden Sie den Wörterbuch-Editor, um neue Parameter hinzuzufügen.
  • Beispiel: query value "select * from Vendor" (für QuickBooks Online).
• Textkörper – Geben Sie eine JSON-Nutzlast ein, die an den angegebenen Endpunkt gesendet wird.

Zusätzliche Eigenschaften

Ausgabe

• Antwortinhalt – Die von der HTTP-Anforderung empfangene Antwort. Dies ist ein JSON-Objekt und kann deserialisiert werden.
• Antwortstatus – Der von der HTTP-Anforderung empfangene Statuscode als Integer-Variable.
• Antwortheader – Die von der HTTP-Anforderung empfangene Antwort.