Skip to content
Hi Walter Docs

Clay HTTP-API

Nutze Hi-Walter-Tools direkt in Clay über die HTTP-API-Anreicherung.

Überblick

Section titled “Überblick”

Clays HTTP-API-Anreicherung lässt dich jede REST-API aufrufen und die Antwort in deine Tabelle übernehmen. Diese Anleitung zeigt dir Schritt für Schritt, wie du ein beliebiges Hi-Walter-Tool mit Clay verbindest.

Voraussetzungen

Section titled “Voraussetzungen”
  • Ein Hi-Walter-API-Key, siehe Authentifizierung zum Erstellen.
  • Eine Clay-Tabelle mit einer Spalte, die die Eingabedaten enthält, die dein gewähltes Tool benötigt.

Setup

Section titled “Setup”

1. HTTP-API-Anreicherungsspalte hinzufügen

Section titled “1. HTTP-API-Anreicherungsspalte hinzufügen”

Klicke in deiner Clay-Tabelle auf + Add column und wähle HTTP API.

2. Request konfigurieren

Section titled “2. Request konfigurieren”

Setze im Konfigurationspanel der HTTP-API die folgenden Felder:

Method

POST

Endpoint

Trage die Endpoint-URL des Hi-Walter-Tools ein, das du verwenden möchtest. Die passende URL findest du auf der API-Referenzseite des jeweiligen Tools. Nicht sicher, welches Tool du brauchst? Siehe Ich habe X, ich will Y.

Headers

KeyValue
Content-Typeapplication/json
AuthorizationBearer YOUR_API_KEY

Ersetze YOUR_API_KEY durch deinen Hi-Walter-API-Key.

Body

Trage den Request-Body so ein, wie er auf der API-Referenzseite des Tools gezeigt wird. Für alle Felder, die aus einer Clay-Spalte gespeist werden sollen, verwende Clays /-Shortcut, um an der Stelle des Werts eine Spaltenreferenz einzufügen.

3. Response konfigurieren

Section titled “3. Response konfigurieren”

Trage im Feld Response values to return Folgendes ein:

results

Damit übernimmst du das gesamte results-Objekt aus der Hi-Walter-Antwort in die HTTP-API-Spalte.

4. Werte in eigene Spalten extrahieren

Section titled “4. Werte in eigene Spalten extrahieren”

Lege für jeden Wert, den du aus der Antwort extrahieren möchtest, eine eigene Spalte an:

  1. Klicke auf + Add column und wähle Formula.
  2. Verwende /, um die HTTP-API-Spalte zu referenzieren.
  3. Wähle im Feld-Picker das gewünschte Feld (z. B. results.email).

Wiederhole das für jedes Feld, das du benötigst.

Clays Pfad-Traversierung der HTTP-API stoppt eine Ebene tief, deshalb greift results.email direkt im Feld Response values to return nicht in das verschachtelte Objekt. Der oben beschriebene Zwei-Spalten-Ansatz ist der vorgesehene Weg.

Kein Ergebnis

Section titled “Kein Ergebnis”

Wenn Hi Walter für eine gegebene Eingabe keine Daten findet, gibt es einen 404-Fehler zurück.

Verwandt

Section titled “Verwandt”