Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.talkturo.ai/llms.txt

Use this file to discover all available pages before exploring further.

Die Talkturo-API nutzt Bearer-Token-Authentifizierung. Jede Anfrage braucht einen gültigen Token im Header Authorization. Sie erzeugen das Token im Talkturo-Dashboard — ohne separates Developer-Konto oder OAuth.

​
API-Token erhalten

1

Dashboard-Einstellungen öffnen

Melden Sie sich an, klicken Sie oben auf Ihren Kontonamen und wählen Sie Einstellungen.
2

Zu API-Schlüssel navigieren

In der Seitenleiste der Einstellungen wählen Sie API-Schlüssel. Dort sehen Sie alle aktiven Tokens.
3

Neuen Schlüssel erstellen

Klicken Sie auf API-Schlüssel erstellen, vergeben Sie einen Namen (z. B. production-integration) und auf Generieren. Kopieren Sie den Token sofort — Talkturo zeigt ihn nur einmal.
Speichern Sie den Token in Umgebungsvariablen oder einem Secrets-Manager. Nicht fest im Quellcode einbetten oder ins Versionsverwaltungssystem committen.

​
Anfragen autorisieren

Übergeben Sie den Token im Header Authorization als Bearer-Credential: 
Authorization: Bearer <your-token>

​
Beispielanfrage

curl https://<your-domain>/api/assistants/asst_01j... \
  -H "Authorization: Bearer <your-token>"

​
Beispiel mit Request-Body

curl -X POST https://<your-domain>/api/assistants \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "accountSlug": "my-team",
    "name": "Support Agent"
  }'

​
Fehlerantworten

​
401 Unauthorized

Ein 401 bedeutet: Token fehlt, ist fehlerhaft oder ungültig. 
{
  "error": "Unauthorized"
}
Behebung: Prüfen Sie den Header Authorization: Bearer <token> und den kopierten Wert. Standardmäßig laufen Tokens nicht ab; widerrufene oder falsch kopierte Tokens führen zu diesem Fehler.

​
403 Forbidden

Ein 403 bedeutet: Token ist gültig, aber die Aktion ist nicht erlaubt — z. B. Aktualisieren eines Assistenten eines anderen Kontos. 
{
  "error": "Forbidden"
}
Behebung: Stellen Sie sicher, dass die Ressource zu dem Konto gehört, zu dem Ihr Token gehört. Bei mehreren Konten jeweils den passenden Token verwenden.