API-Referenz

Überblick

Die REST API bietet vollständigen programmatischen Zugriff auf deinen KI-Agenten. Nutze sie, um eigene Chat-Oberflächen zu erstellen, Abläufe zu automatisieren oder vorhandene Werkzeuge zu integrieren.

Basis-URL

https://api.your-domain.com/v1

Direktlinks

• Authentifizierung — API-Schlüssel und Authentifizierungsmethoden
• Streaming — Antworten in Echtzeit streamen
• Fehlerbehandlung — Fehlercodes und Fehlerbehebung
• Paginierung — Große Ergebnismengen durchlaufen

Endpunkte

• Chat — Nachrichten senden und Antworten empfangen
• Unterhaltungen — Gesprächsverläufe verwalten
• Nachrichten — Auf einzelne Nachrichten zugreifen

Antwortformat

Alle Antworten verwenden JSON mit einer einheitlichen Struktur:

{
  "data": { ... },
  "meta": {
    "request_id": "req_abc123"
  }
}

Fehlerantworten folgen demselben Muster:

{
  "error": {
    "code": "invalid_request",
    "message": "The 'message' field is required."
  },
  "meta": {
    "request_id": "req_abc123"
  }
}