APICall

HTTP-Requests ausführen (Daten abrufen) , HTTP-Requests ausführen (Daten senden)

Stellt eine API/HTTP-Anfrage. Unterstützt das Parsen von XML/JSON-Antworten und sog. Weiterblättern (Pagination).

Dokumentation im Handbuch aufrufen

Warum Synesty?

  • Zentrale Middleware für Anbindungen, Datenfeeds & Schnittstellen zur Automatisierung von Geschäftsprozessen
  • Keine Programmierkenntnisse notwendig - nur Drag&Drop und Konfiguration
  • Schneller und professioneller Support
Kostenlos testen Demo

Passende Vorlagen

Warum Synesty?

  • Zentrale Middleware für Anbindungen, Datenfeeds & Schnittstellen zur Automatisierung von Geschäftsprozessen
  • Keine Programmierkenntnisse notwendig - nur Drag&Drop und Konfiguration
  • Schneller und professioneller Support
Kostenlos testen Demo

Passende Vorlagen

Inputs

Name Datentyp Beschreibung Pflichtfeld Werte
host STRING Die URL (e.g. http://www.mywebsite.com/page.html) der ersten Anfrage (initialUrl). Nutzen Sie die ${nextUrl('...')} Funktion im parsingTemplate um weitere Anfragen zu senden. Das Protokoll kann weggelassen werden und wird standardmäßig durch http:// ersetzt. Ja
method STRING Die HTTP-Methode (GET, POST, HEAD, PUT, PATCH, DELETE). Ja
  • GET (Standardwert)
  • POST
  • HEAD
  • PUT
  • PATCH
  • DELETE
username STRING Wenn die URL mit HTTP BASIC AUTH geschützt ist, ist dies der Benutzername. Nein
password STRING Das HTTP BASIC AUTH Passwort. Nein
errorStatusCodes STRING Eine kommagetrennte Liste von HTTP-Statuscodes, bei denen der Flow die Ausführung stoppt, z.B. 403,404,500. Lassen Sie das Feld leer für alle Statuscodes größer als 300. Nein
requestBody STRING Optional: Versendet direkt den HTTP-Request-Body. Dies kann nützlich sein, wenn Sie mit einen XML oder JSON Webservices anbinden. Sie können die vollständige XML-Anfrage in dieses Textfeld eingeben. Nur möglich mit der HTTP-Methode POST, PATCH, PUT. Bei bodyContentType=multipart/form-data (oder Dateiupoad mit fileToUpload) kann man auch Form-Parameter übermitteln z.B. ¶m1=value1¶m2=value2 (wenn die URL/host keine Parameter hat, dann ohne das erste &-Zeichen). Es ist auch für bessere Lesbarkeit möglich, pro Zeile einen Parameter zu verwenden. Wichtig ist, dass der Wert keine Zeilenumbrüche beinhaltet. Für mehrzeilige Werte sollte die Freemarker <#compress> function probiert werden. Nein
fileToUpload FILE Optional: Sendet die Datei direkt im Anfragetext. Nein
fileParameterName STRING Optional: Der Name des HTTP-Request-Parameters, unter dem die Datei hochgeladen wird. (Standard wenn leer: 'upfile') Nein
responseFormat STRING Das Datenformat der Antwort (XML/JSON). Ja
  • XML (Standardwert)
    Die Antwort auf die Anfrage sind XML-Daten.
  • JSON
    Die Antwort auf die Anfrage sind JSON-Daten. In der Regel für REST-APIs.
parsingTemplate STRING Template in Freemarker-Syntax, um die Antwort in ein Spreadsheet zu transformieren. Nutzen Sie die ${nextUrl('...')} Funktion zum Abruf weiterer URLs/Seiten. Wenn Sie eine nextUrl angeben, wird diese URL aufgerufen, bis keine nextUrl übergeben wird oder die Anrufgrenze (numCalls) erreicht ist. Mit der Funktion ${setVariable('key','value')} können Sie eine Variable erstellen/setzen, die im requestBody für alle Requests nach der ersten verwendet werden kann. Nein
sourcefileCharset STRING Der Zeichensatz der Antwort. Nein
  • Standard
    Der Zeichensatz der Antwort.
  • UTF-8
  • UTF-16
  • ISO-8859-1
  • ISO-8859-2
  • ISO-8859-4
  • ISO-8859-5
  • ISO-8859-15
  • cp1252 (Windows-1252, ANSI)
  • MacCentralEurope
  • US-ASCII
  • KOI8-R
bodyContentType STRING Optional: Der Content type des requestBody. Nein
  • application/octet-stream
  • application/xhtml+xml; charset=ISO-8859-1
  • application/json; charset=UTF-8
  • application/xml; charset=ISO-8859-1
  • text/html; charset=ISO-8859-1
  • text/plain; charset=ISO-8859-1
  • text/xml; charset=ISO-8859-1
  • application/x-www-form-urlencoded; charset=ISO-8859-1
  • multipart/form-data; charset=ISO-8859-1
  • text/csv; charset=UTF-8
requestHeaders STRING Optional: Zusätzliche HTTP-Request-Header, die dem HTTP-Request als key=value-Paare (ein Paar pro Zeile) hinzugefügt wurden. Nein
timeoutInSeconds STRING Optional: HTTP-Verbindung und Read-(Socket) Zeitüberschreitung in Sekunden. Standard: 60s. Wenn der Zielhost länger als die angegebene Zeit benötig um zu Antworten schlägt der Step fehl. Nein Standardwert: 60
sslCertificates STRING Fortgeschrittenene Einstellung für HTTPS-URLs: Unter normalen Umständen führen URLs, die nur ein selbst signiertes SSL-Zertifikat haben, zu einem Fehler. Sie können den Fehler verhindern, indem Sie diesen auf 'Vertrauen Sie selbstsignierten SSL-Zertifikaten.' setzen. Dies kann jedoch ein Sicherheitsrisiko darstellen, da bösartige Websites dies missbrauchen können, um sensible Informationen zu stehlen. Verwenden Sie dies nur, wenn Sie wissen, was Sie tun! Nein
  • Vertrauen Sie keine selbst signierte SSL-Zertifikate (Standard). (Standardwert)
  • Vertrauen Sie selbstsignierten SSL-Zertifikaten (Sicherheitswarnung).
callLimit STRING Begrenzen Sie die Anzahl der Anrufe. Nein Standardwert: 10
rateLimitPerSecond STRING Mit dieser Option können Sie die Anzahl der Aufrufe pro Sekunde begrenzen, z.B. 2 Aufrufe/s (=120 Aufrufe/Minute). Oder 0,5 Anrufe/s bedeutet 2 Sekunden Verzögerung nach jedem Aufruf. Standard: Leer = Keine Begrenzung. Nein
account ACCOUNT Wählen sie einen HTTP account für eine Client Zertifikat-basierte Authentifizierung Nein

Outputs

Name Datentyp Beschreibung
output SPREADSHEET Die Ausgabe als Spreadsheet.
numCalls STRING Die maximale Anzahl der Aufrufe.
responses STRINGLIST Die unverarbeitete Antwort (zum Debuggen nur während der Vorschau).
sentRequests STRINGLIST Die gesendeten Anfragen (zum Debuggen nur während der Vorschau).

Hilfe oder Projektsupport gewünscht?

Wenn Sie Hilfe bei der Einrichtung dieses Steps benötigen oder ein Projekt umsetzen wollen, dann unterstützen Sie unsere zertifizierten Partner. Partner finden

Weitere Steps in Plus


Name Version Beschreibung Anwendungsfall
Archive
Archive
- Compresses a single FILE or a FILELIST into a ZIP-archive.
EmailSend
EmailSend
- This step sends a single email.
Nachrichten senden
FTPRename
FTPRename
- This step renames a list of files on FTP. Currently there are two modes which are support: 1. Rename a single file to a new fileName or prefix the oldfilename Here you need to specify the input parameter remoteFilename and the parameter newRemoteFilenamePrefix or newRemoteFilename 2. Rename a list of files using a prefix which will be infront of the new Filename (e.g. [DONE_]OLDFILENAME.xml) Here you need to input a List which currently needs to be the result of another service which is executed before this step.
Dateien senden oder hochladen
JSONReader
JSONReader
- Reads a JSON file into a Spreadsheet object.
JSON Daten
ToList
ToList
- Creates a list of serveral inputs.
XMLSplitter
XMLSplitter
- Split a large XML File into multiple smaller XML files.
XML Daten
XMLReaderVisual
XMLReaderVisual
- Reads XML file into a Spreadsheet object.
XML Daten abfragen
WebDAVUpload
WebDAVUpload
- This step upload files to a WebDAV-Server.
Dateien senden oder hochladen
FlowTrigger
FlowTrigger
- A step which can trigger another flow asynchronously. The run will count as a separate run. It can be used to execute a sub-process with a pause or delay.
AddUpdateMappingset
AddUpdateMappingset
- Creates or updates a mappingset based on 2 columns of a Spreadsheet.
KeyValueSpreadsheet
KeyValueSpreadsheet
- Converts a Spreadsheet into a special Spreadsheet which can be used as a key-value map.
FlowExecutingStep
FlowExecutingStep
- A step which can execute another Flow.
APICall
APICall
- Makes an API Request. Supports parsing of XML/JSON responses and pagingation.
HTTP-Requests ausführen (Daten abrufen) , HTTP-Requests ausführen (Daten senden)
FTPSingleFileDownload
FTPSingleFileDownload
- This step downloads one single file from FTP. Currently you can specify a filenamePrefix and suffix to filter for the files you want to download. If there are multiple files which match the criteria only the first one is taken. The files will be ordered by descending modification date on FTP so the latest file would be taken out of a list.
Dateien empfangen oder herunterladen
FTPUpload
FTPUpload
- This step uploads a list of files to a FTP.
Dateien senden oder hochladen
WebDAVDownload
WebDAVDownload
- This step downloads files from a WebDAV-Server. The result is a list of files.
Dateien empfangen oder herunterladen
WebDAVRename
WebDAVRename
- This step renames a single file or a list of files on a WebDAV-Server. You can also move the file(s) into a existing subfolder.
ExtractArchive
ExtractArchive
- Extracts (decompresses) an archive (ZIP,TAR,TARGZ,GZ,7z,LZMA)-archive into a FILELIST (Unzip)
Dateien empfangen oder herunterladen
SpreadsheetUrlDownload
SpreadsheetUrlDownload
- This step can download content from multiple URLs based on a SPREADSHEET or SPREADSHEET list. Use it to connect to various kinds of Webservice APIs.
HTTP-Requests ausführen (Daten abrufen) , HTTP-Requests ausführen (Daten senden)
XMLReader
XMLReader
- Reads a XML file into a Spreadsheet object.
XML Daten
FTPRemove
FTPRemove
- Deletes a file or filelist from FTP or SFTP server. Hinweis: Die Benutzung des FTPRemove Steps erfolgt auf eigene Gefahr. Falsche Konfiguration kann zu Datenverlust führen. Wir übernehmen keine Haftung für Datenverlust der durch falsche Konfiguration entsteht. Wir empfehlen stattdessen den Step FTPRename zu nutzen, und die Dateien z.B. in einen "archive" Ordner zu verschieben und mit einem Datum zu versehen und diesen regelmäßig per Hand zu sichten und ggf. zu löschen. Das ist gängige Praxis und hat den Vorteil, dass sie eine Historie sowie Backup der verarbeiteten Daten haben.
JSONReaderVisual
JSONReaderVisual
- Reads JSON into a Spreadsheet object providing a simple graphical User-Interface.
JSON Daten abfragen
FTPDownload
FTPDownload
- This step downloads files from FTP. The result is a list of files. Currently you can specify a filenamePrefix and suffix to filter for the files you want to download.
Dateien empfangen oder herunterladen
UrlDownload
UrlDownload
- This step accesses an URL and downloads the content. The result is String value.
HTTP-Requests ausführen (Daten abrufen) , HTTP-Requests ausführen (Daten senden)