Dein erster Tag mit der Tale-API

Dieser Einstieg ist für die Person, die Tale mit anderen Systemen verdrahtet. In zehn Minuten erstellst du einen API-Schlüssel, machst deine erste authentifizierte Anfrage und weißt, an welche Tür du für Chat, Workflows und Dokumente klopfst.

Du brauchst die Rolle Entwickler oder höher (darunter sind die API-Einstellungen ausgeblendet) auf einer laufenden Instanz — der Quickstart hilft, wenn du keine hast. Ersetze unten your-host.example.com durch den Host deiner Instanz.

1. 1

   Erstelle einen API-Schlüssel

   Für einen Berechtigungsnachweis, den deine Skripte halten können, öffne Einstellungen > API > REST und klicke auf API-Schlüssel erstellen. Benenne ihn nach dem System, das ihn nutzen wird — Schlüssel werden nach Namen gelistet, und in einem Jahr schlägt „zapier-bridge“ jedes „test“. Der Schlüsselwert erscheint genau einmal, bei der Erstellung; leg ihn in deinen Secret-Manager, nicht in den Code.

   

2. 2

   Mach die erste Anfrage

   Der kürzeste nützliche Aufruf listet die Agents, die dein Schlüssel sehen kann. Der Schlüssel reist als Bearer-Token mit; den Arbeitsbereichs-Kontext leitet Tale aus dem Schlüssel selbst ab:

   bash

   curl -sS https://your-host.example.com/api/v1/agents \
     -H "Authorization: Bearer $TALE_API_KEY"

Der Rest der Oberfläche

Alles Weitere sind Variationen dieser Anfrage. Die OpenAI-kompatiblen Endpunkte (/api/v1/chat/completions, /api/v1/models) bedeuten: Bestehende SDKs funktionieren, sobald du die Basis-URL tauschst. Workflows laufen per Slug über /api/v1/workflows/<slug>/run mit demselben Bearer-Schlüssel — oder werden von außen über Webhook-URLs der Form /api/workflows/wh/<token> gefeuert; das Token in der URL ist der Berechtigungsnachweis. Dokumente laden über /api/v1/documents hoch. Die API-Referenz ist das vollständige Inventar mit Auth, Datenformen und Limits.

Wo du jetzt stehst

Du hältst einen funktionierenden Berechtigungsnachweis und hast die Anfrageform gesehen, die jeder Endpunkt teilt. Von hier aus macht Tale aus einem Skript aufrufen aus dem curl eine echte Integration, einen Workflow per Webhook auslösen behandelt die Push-Richtung, und Webhooks dokumentiert die Payloads, die Tale dir sendet.