REST API
Sendet HTTP-Requests an beliebige URLs. Der universelle Block für die Anbindung externer APIs, Webhooks und Webservices. Unterstützt GET, POST, PUT, PATCH und DELETE.
Kategorie: Web & Daten | Quelldatei: restAPIBlock.js | Auth: Nein (aber die Ziel-API kann Auth erfordern)
Was kann dieser Block?
- Daten von jeder beliebigen API abrufen (GET)
- Daten an eine API senden (POST)
- Bestehende Daten aktualisieren (PUT/PATCH)
- Daten löschen (DELETE)
- Beliebige Header und Body konfigurieren
- Antworten als JSON, Text oder Raw verarbeiten
Was brauche ich dafür?
Für den Block selbst: Nichts. Aber die Ziel-API kann einen API-Key oder Token erfordern — diesen trägst du dann in den Headers ein.
So benutzt du den Block
Daten von einer API abrufen
Prompt: "Rufe den ersten Beitrag von jsonplaceholder ab"
Ergebnis: JSON-Antwort mit Titel und Inhalt des Beitrags.
Daten an eine API senden
Prompt: "Sende einen POST-Request an https://api.example.com/data mit dem Inhalt: Name ist Test"
Ergebnis: API-Antwort mit dem erstellten Datensatz.
API mit Authentifizierung
Prompt: "Rufe die Daten von der API ab. Nutze den Bearer Token sk-abc123"
Ergebnis: Authentifizierter API-Request mit Antwort.
Alle Funktionen im Überblick
| Methode | Wofür | Beispiel-Prompt |
|---|---|---|
| GET | Daten abrufen | "Rufe die aktuellen Daten von der API ab" |
| POST | Neue Daten erstellen | "Sende einen neuen Eintrag an die API" |
| PUT | Daten komplett ersetzen | "Aktualisiere den Datensatz" |
| PATCH | Daten teilweise ändern | "Ändere nur das Statusfeld" |
| DELETE | Daten löschen | "Lösche den Eintrag mit ID 123" |
Häufige Probleme und Lösungen
| Problem | Lösung |
|---|---|
| 401/403 Fehler | Die Ziel-API braucht Authentifizierung — API-Key oder Token in den Headers eintragen |
| Timeout | API antwortet zu langsam — Timeout erhöhen |
| "Invalid JSON" im Body | JSON-Syntax prüfen, z.B. auf https://jsonlint.com/ |
| Leere Antwort | Manche APIs geben 204 No Content zurück — das ist normal |
| Block wird vom AgentLoop nicht aufgerufen | Prüfen ob der REST-API-Block in den enabledTools aktiviert ist |
Weiterführende Links
- HTTP-Methoden: https://developer.mozilla.org/de/docs/Web/HTTP/Methods
- JSONPlaceholder (Test-API): https://jsonplaceholder.typicode.com/
- JSON Validator: https://jsonlint.com/
Technische Details
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
url | Text | Ja | Die Ziel-URL |
method | Select | Ja | HTTP-Methode: GET, POST, PUT, PATCH, DELETE |
headers | Textarea | Nein | HTTP-Header als JSON (z.B. {"Authorization": "Bearer ..."}) |
body | Textarea | Nein | Request-Body für POST/PUT/PATCH |
responseType | Select | Nein | Antwortformat: auto, json, text, blob. Standard: auto |
timeoutMs | Number | Nein | Timeout in ms. Standard: 15000 |