REST API - Get

Dieser Funktionsblock ist so konzipiert, dass er Daten von einem bestimmten REST-API-Server mithilfe einer GET-Anfrage abruft. Er ermöglicht es den Benutzern, eine Serveradresse anzugeben und eine optionale Daten-ID, um die entsprechenden Daten abzurufen.

📥 Eingänge

Enable Condition Eingabe eines boolean Wertes, der den API-Aufruf aktiviert, wenn er auf true gesetzt ist.

Server Address Eine Eingabezeichenfolge zur Angabe des Endpunkts der REST-API, von der Daten abgerufen werden.

Data ID Optionale Eingabezeichenfolge, um einen Schlüssel aus der API-Antwort anzugeben, um spezifische Daten zu extrahieren.

📤 Ausgänge

Status Code Diese Ausgabe zeigt den HTTP-Statuscode, der vom Server nach der GET-Anfrage zurückgegeben wird.

Error Diese Ausgabe gibt eine Fehlermeldung zurück, die vom Server empfangen wurde, falls die Anfrage nicht erfolgreich war.

Response Diese Ausgabe enthält die vom Server zurückgegebenen Daten, die entweder aus reinem Text oder JSON-Daten bestehen können, die der angegebenen Daten-ID entsprechen.

🕹️ Steuerungen

Timeout (s) Ein Textfeld, in dem der Benutzer die Timeout-Dauer für die Serveranfrage in Sekunden angeben kann.

🎨 Funktionen

Conditional Execution Dieser Block führt den API-Aufruf nur aus, wenn die Aktivierungsbedingung gesetzt ist, um Effizienz und Kontrolle über den Anfrageprozess zu gewährleisten.

Dynamic Response Handling Benutzer können sowohl rohe Antworten als auch spezifische Datenelemente aus der JSON-Antwort basierend auf der bereitgestellten Daten-ID empfangen.

📝 Nutzungshinweise

1. Set Enable Condition: Verbinden Sie einen boolean Wert, um die Ausführung der Anfrage zu aktivieren.

2. Enter Server Address: Geben Sie die REST-API-Endpunkt-URL in das Eingabefeld Server Address ein.

3. Optional Data ID: Wenn Sie ein bestimmtes Stück Daten aus der Antwort abrufen möchten, geben Sie den entsprechenden Schlüssel in das Eingabefeld Data ID ein.

4. Set Timeout: Geben Sie die Timeout-Dauer an, um auf die Serverantwort in Sekunden zu warten.

5. Evaluate: Führen Sie den Block aus, um die GET-Anfrage auszuführen und die Daten abzurufen.

📊 Bewertung

Bei der Auswertung führt dieser Funktionsblock die angegebene GET-Anfrage aus und gibt den Statuscode, etwaige Fehlermeldungen und den Inhalt der Antwort zurück.

💡 Tipps und Tricks

Gewährleistung der API-Zugänglichkeit

Stellen Sie vor dem Festlegen der Serveradresse sicher, dass der REST-API-Server erreichbar ist und die URL korrekt ist. Verwenden Sie Ihren Webbrowser, um zu überprüfen, ob der Endpunkt Daten zurückgibt.

Antworten debuggen

Wenn es ein Problem mit der Antwort gibt, überprüfen Sie die Ausgabe Error für weitere Informationen. Dies kann Aufschluss darüber geben, was schiefgelaufen ist (z. B. 404-Fehler, Serverunverfügbarkeit).

Umgang mit komplexen Antworten

Bei komplexen JSON-Antworten sollten Sie eine Kombination von Blöcken wie JSON Parser oder Data Type Converter in Betracht ziehen, um Daten weiter zu extrahieren und zu bearbeiten.

🛠️ Fehlersuche

Keine Antwort empfangen

Wenn Sie keine Antwort erhalten, überprüfen Sie, ob die Serveradresse korrekt ist, und prüfen Sie, ob der Server aktiv ist und in der Lage ist, Anfragen zu bearbeiten.

Timeout-Fehler

Wenn ein Timeout-Fehler auftritt, überlegen Sie, die Timeout-Dauer im Eingabefeld Timeout (s) zu erhöhen, um dem Server mehr Zeit zum Antworten zu geben.