API: eigene Werkzeuge bauen

Zwei Zugänge von außen — einer in deine Daten, einer zu den Modellen. Beide mit einem Schlüssel, den du selbst anlegst.

Wofür das gedacht ist

Nicht jede Aufgabe gehört in ein Gespräch. Manchmal soll einfach ein Skript nachts eine Liste durchgehen, ein Shop-System einen neuen Kunden anlegen oder ein eigenes kleines Werkzeug genau eine Sache tun. Dafür gibt es zwei Zugänge:

Daten-API — dieselben Werkzeuge, mit denen der Assistent arbeitet: lesen, schreiben, Dokumente erzeugen, Verlauf, Rückgängig. Adresse /api/v1/…, Schlüssel beginnt mit scrm_api_.
LLM-Gateway — Modellaufrufe über dein Guthaben, im OpenAI-Format. Adresse /api/llm/v1, Schlüssel beginnt mit scrm_llm_.

Die beiden sind unabhängig. Du kannst die Daten-API benutzen und die Modelle woanders einkaufen, oder umgekehrt.

Schlüssel anlegen

Zahnrad unten links, dann Connectoren. Dort legst du je Zugang einen Schlüssel an und vergibst einen Namen — der steht später im Verlauf bei allem, was über diesen Schlüssel passiert.

Der Schlüssel erscheint genau einmal. Kopiere ihn sofort; geht er verloren, widerrufe ihn und leg einen neuen an.

Er gehört in den Kopf der Anfrage:

Authorization: Bearer scrm_api_…

Nicht in die Adresse. Adressen landen in Protokollen, Zwischenstationen und im Browserverlauf — ein Anhängen der Art ?token=… unterstützen wir bewusst nicht.

Ein Schlüssel, ein Arbeitsbereich

Ein Schlüssel gehört fest zu dem Arbeitsbereich, in dem du ihn angelegt hast. Wechselst du im Browser den Arbeitsbereich, wandert er nicht mit. Und er kann nie mehr als du selbst: Wirst du auf Betrachter zurückgestuft, verliert er im selben Moment das Schreiben.

Die maschinenlesbare Beschreibung

https://silentcrm.de/api/v1/openapi.json

Eine vollständige OpenAPI-3.1-Datei mit allen Werkzeugen, Parametern und Antwortformen. Sie wird aus demselben Verzeichnis erzeugt, aus dem auch der Assistent seine Werkzeuge nimmt — sie kann also nicht veralten. Damit baust du dir in einem Befehl einen Client:

npx @openapitools/openapi-generator-cli generate -i https://silentcrm.de/api/v1/openapi.json -g typescript-fetch -o ./silentcrm-client

Oder du importierst sie in Postman, Insomnia oder Bruno. Oder du hängst sie einem Agenten als Werkzeugbeschreibung an.

Grenzen

120 Aufrufe pro Minute und Schlüssel. Wird es mehr, kommt 429 — kurz warten, dann weiter. Nach zu vielen Fehlversuchen mit einem ungültigen Schlüssel wird dieselbe Adresse eine Weile ausgesperrt.

Was von außen passiert, siehst du

Jede Änderung über einen Schlüssel steht im Verlauf mit dessen Namen und lässt sich dort herausfiltern — Filter Von außen (Agent). Rückgängig machen geht wie bei allem anderen.