API-Übersicht
Starten Sie mit der Talkturo REST-API — Basis-URL, Authentifizierung, Antwortformat, Ratenlimits und verfügbare Endpunktgruppen.
Entwickeln Sie auf der Talkturo API
Erstellen Sie Integrationen und Automatisierungen auf Basis der Voice-AI-Plattform von Talkturo mit einer REST-API für Assistenten, Telefonie, Telefonnummern, Guthaben, CRM-Daten, Workflows und Kontoverwaltung. Auf dieser Seite lernen Sie die grundlegenden API-Konventionen kennen und finden die Endpunktgruppe, die Sie benötigen.
Senden Sie alle API-Anfragen an https://app.talkturo.com/api.
Authentifizieren Sie Anfragen
Talkturo unterstützt drei Authentifizierungsmethoden. Die meisten externen Integrationen sollten API-Schlüssel verwenden, während Browser- und Desktop-Clients plattformspezifische Authentifizierungsabläufe nutzen.
Verwenden Sie ein Bearer-Token, das mit tk_live_ oder tk_test_ beginnt, um Server-zu-Server-Anfragen zu authentifizieren. API-Schlüssel unterstützen Scopes und haben standardmäßig ein Ratenlimit von 1000 Anfragen pro Stunde.
Unter Authentifizierung finden Sie das Header-Format, das Verhalten von Scopes und Sicherheitshinweise.
Die Talkturo-Web-App verwendet authentifizierte Sitzungs-Cookies für browserbasierte Anfragen. Diese Methode ist für Web-Sitzungen der eigenen Anwendung vorgesehen, nicht für externe Backend-Integrationen.
Unter Authentifizierung erfahren Sie, wann sitzungsbasierte Authentifizierung zum Einsatz kommt.
Die Desktop-App verwendet Bearer-JWT-Token für authentifizierten API-Zugriff. Dieser Ablauf ist speziell für Desktop-Clients gedacht, die sich über Talkturo-Benutzersitzungen authentifizieren.
Weitere Informationen finden Sie unter Authentifizierung und Desktop-Authentifizierung.
Antwortformat verstehen
Die meisten Endpunkte geben JSON in einem einheitlichen Format zurück, sodass Sie Erfolg und Misserfolg vorhersehbar behandeln können. Erfolgreiche Antworten geben ein success-Flag und Antwortdaten zurück, während fehlgeschlagene Antworten ein success-Flag und Fehlerdetails zurückgeben.
HTTP-Statuscodes
| Status | Bedeutung |
|---|---|
200 | Anfrage erfolgreich |
201 | Ressource erstellt |
400 | Ungültige Anfrage |
401 | Nicht autorisiert |
402 | Ungenügendes Guthaben |
403 | Verboten |
404 | Nicht gefunden |
500 | Serverfehler |
Ratenlimits
API-Schlüssel sind standardmäßig auf 1000 Anfragen pro Stunde begrenzt. Wenn Sie Hintergrundjobs, Wiederholungen oder Massensynchronisierungen entwickeln, fügen Sie Backoff- und Wiederholungsbehandlung hinzu.
Endpunktgruppen durchsuchen
Beginnen Sie mit der Gruppe, die zur Ressource oder zum Workflow passt, den Sie integrieren möchten. Jede Referenzseite dokumentiert Endpunkte, Authentifizierungsanforderungen und Anfrage-/Antwortdetails.
Mit dem häufigsten Integrationspfad beginnen
Die meisten externen Entwickler beginnen mit API-Schlüsseln und gehen dann zu Assistenten-, Telefonie- oder CRM-Endpunkten über, je nach Produkt.