Benutzer und Konto
Verwalten Sie Benutzerprofile, Abonnements, Workspaces und Geschäftseinstellungen über die Talkturo API — rufen Sie aktuelle Benutzerdaten ab, prüfen Sie Abonnement-Limits, listen Sie Workspaces auf und aktualisieren Sie Geschäftsprofile.
curl -X GET "https://app.talkturo.com/api/users/me" \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c3JfYTFiMmMzZDQiLCJlbWFpbCI6ImphbmVAYWNtZS5jb20ifQ.signature_example_7xk29"
{
"uid": "usr_a1b2c3d4",
"email": "jane@acme.com",
"display_name": "Jane Chen",
"auto_update_enabled": true,
"has_migrated_to_firebase": true
}
curl -X PUT "https://app.talkturo.com/api/users/me" \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c3JfYTFiMmMzZDQiLCJlbWFpbCI6ImphbmVAYWNtZS5jb20ifQ.signature_example_7xk29" \
-H "Content-Type: application/json" \
-d '{
"display_name": "Jane Chen"
}'
{
"uid": "usr_a1b2c3d4",
"email": "jane@acme.com",
"display_name": "Jane Chen",
"auto_update_enabled": true,
"has_migrated_to_firebase": true
}
curl -X GET "https://app.talkturo.com/api/users/me/subscription" \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c3JfYTFiMmMzZDQiLCJlbWFpbCI6ImphbmVAYWNtZS5jb20ifQ.signature_example_7xk29" \
-H "X-Talkturo-Account: acme-sales"
{
"success": true,
"hasActiveSubscription": true,
"data": {
"active": true,
"plan": "team",
"source": "stripe",
"current_period_end": "2026-01-31T23:59:59.000Z",
"trial_ends_at": null,
"account_id": "acc_7f2k9m1q",
"account_slug": "acme-sales",
"access_blocked_reason": null,
"limits": {
"seats": 10,
"calls_per_month": 5000,
"session_max_minutes": 60,
"retention_days": 90,
"sales_modes": true
},
"usage": {
"calls_this_month": 842,
"calls_limit": 5000
}
}
}
curl -X GET "https://app.talkturo.com/api/users/me/workspaces" \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c3JfYTFiMmMzZDQiLCJlbWFpbCI6ImphbmVAYWNtZS5jb20ifQ.signature_example_7xk29"
{
"success": true,
"workspaces": [
{
"account_id": "acc_7f2k9m1q",
"slug": "acme-sales",
"name": "Acme Sales",
"is_personal_account": false,
"role": "owner",
"has_desktop_plan": true,
"has_desktop_access": true,
"plan": "team"
},
{
"account_id": "acc_3d8n2p6r",
"slug": "jane-chen",
"name": "Jane Chen",
"is_personal_account": true,
"role": "owner",
"has_desktop_plan": false,
"has_desktop_access": true,
"plan": "free"
}
]
}
curl -X GET "https://app.talkturo.com/api/account/business?account=acme-sales" \
-H "Cookie: sb-access-token=session_example_4km82p; sb-refresh-token=refresh_example_9qp31x"
{
"success": true,
"business": {
"business_name": "Acme Sales GmbH",
"business_website": "https://acme-sales.com",
"business_industry": "Software",
"business_phone": "+49 30 12345678",
"business_city": "Berlin",
"business_state": "Berlin",
"business_country": "DE"
}
}
curl -X PUT "https://app.talkturo.com/api/account/business" \
-H "Content-Type: application/json" \
-H "Cookie: sb-access-token=session_example_4km82p; sb-refresh-token=refresh_example_9qp31x" \
-d '{
"account": "acme-sales",
"businessName": "Acme Sales GmbH",
"businessWebsite": "https://acme-sales.com",
"businessIndustry": "Software",
"businessPhone": "+49 30 12345678",
"businessCity": "Berlin",
"businessState": "Berlin",
"businessCountry": "DE"
}'
{
"success": true,
"business": {
"business_name": "Acme Sales GmbH",
"business_website": "https://acme-sales.com",
"business_industry": "Software",
"business_phone": "+49 30 12345678",
"business_city": "Berlin",
"business_state": "Berlin",
"business_country": "DE"
}
}
curl -X PUT "https://app.talkturo.com/api/account/language" \
-H "Content-Type: application/json" \
-H "Cookie: sb-access-token=session_example_4km82p; sb-refresh-token=refresh_example_9qp31x" \
-d '{
"account": "acme-sales",
"language": "de"
}'
{
"success": true,
"language": "de"
}
Benutzer- und Kontoendpunkte
Diese Endpunkte decken das aktuelle Benutzerprofil, Abonnementdaten, Workspace-Zugriff und Geschäftseinstellungen ab. Desktop-Endpunkte erwarten ein Desktop-JWT im Authorization-Header, während Kontoendpunkte mit Session-Cookie die aktive Web-Session verwenden.
Base URL: https://app.talkturo.com
Authentifizierung nach Endpunkt
Verwenden Sie für Desktop-Endpunkte ein Bearer-Token im Authorization-Header.
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c3JfYTFiMmMzZDQiLCJlbWFpbCI6ImphbmVAYWNtZS5jb20ifQ.signature_example_7xk29
Diese Authentifizierung gilt für:
GET /api/users/mePUT /api/users/meGET /api/users/me/subscriptionGET /api/users/me/workspacesPOST /api/users/me/auto-update
Verwenden Sie für Kontoeinstellungen Ihre aktive Web-Session. Diese Endpunkte akzeptieren kein Desktop-JWT als Ersatz.
Diese Authentifizierung gilt für:
GET /api/account/businessPUT /api/account/businessGET /api/account/languagePUT /api/account/languageGET /api/account/verificationsPOST /api/account/verifications
Der Endpunkt PUT /api/account/language ist nur für Workspace-Owner verfügbar.
Aktuellen Benutzer abrufen
Rufen Sie das Profil des aktuell authentifizierten Desktop-Benutzers ab.
Antwortfelder von GET /api/users/me
Eindeutige Kennung des aktuellen Benutzers.
E-Mail-Adresse des aktuellen Benutzers.
Anzeigename des Benutzers.
Gibt an, ob automatische Updates im Desktop-Client aktiviert sind.
Gibt an, ob das Benutzerkonto zu Firebase migriert wurde.
Aktuellen Benutzer aktualisieren
Aktualisieren Sie den Anzeigenamen des aktuell authentifizierten Desktop-Benutzers.
Request-Body für PUT /api/users/me
Neuer Anzeigename des aktuellen Benutzers.
Abonnement abrufen
Rufen Sie den Abonnementstatus, Planinformationen, Limits und aktuelle Nutzung des authentifizierten Benutzers ab. Optional können Sie mit dem Header X-Talkturo-Account einen bestimmten Workspace-Kontext angeben.
Header und Antwortfelder für GET /api/users/me/subscription
Bearer-Token des Desktop-Benutzers.
Optionaler Workspace-Slug, um das Abonnement im Kontext eines bestimmten Workspace abzurufen.
Gibt an, ob die Anfrage erfolgreich verarbeitet wurde.
Gibt an, ob für den aktuellen Benutzer oder den angegebenen Workspace ein aktives Abonnement vorliegt.
Enthält die Abonnementdetails, Limits und Nutzungswerte.
Felder in data
Gibt an, ob das Abonnement aktuell aktiv ist.
Planname des aktiven Abonnements.
Quelle des Abonnements, zum Beispiel ein externer Billing-Anbieter.
Zeitpunkt, an dem der aktuelle Abrechnungszeitraum endet.
Zeitpunkt, an dem eine Testphase endet, falls vorhanden.
Eindeutige Kennung des Workspace-Kontos.
Slug des Workspace-Kontos.
Grund für einen gesperrten Zugriff, falls der Zugriff auf das Abonnement oder den Workspace eingeschränkt ist.
Abonnementlimits für Plätze, Anrufe und verfügbare Funktionen.
Aktuelle Nutzung im laufenden Zeitraum.
Felder in limits
Maximale Anzahl an Benutzerplätzen.
Maximale Anzahl an Anrufen pro Monat.
Maximale Sitzungsdauer in Minuten.
Anzahl der Tage, für die Daten aufbewahrt werden.
Gibt an, ob vertriebsbezogene Modi im Plan enthalten sind.
Felder in usage
Bisher verbrauchte Anrufe im aktuellen Monat.
Monatliches Anruflimit, das für die Nutzungsauswertung herangezogen wird.
Workspaces auflisten
Listen Sie alle Workspaces auf, auf die der aktuelle Desktop-Benutzer Zugriff hat.
Antwortfelder von GET /api/users/me/workspaces
Gibt an, ob die Anfrage erfolgreich war.
Liste aller Workspaces, auf die der aktuelle Benutzer zugreifen kann.
Felder pro Workspace
Eindeutige Konto-ID des Workspace.
Slug des Workspace.
Anzeigename des Workspace.
Gibt an, ob es sich um einen persönlichen Workspace handelt.
Rolle des aktuellen Benutzers in diesem Workspace.
Gibt an, ob für den Workspace ein Desktop-Plan hinterlegt ist.
Gibt an, ob der aktuelle Benutzer Desktop-Zugriff für diesen Workspace hat.
Planname des Workspace.
Geschäftsprofil abrufen
Rufen Sie das Geschäftsprofil eines Workspace über dessen Slug ab. Dieser Endpunkt verwendet die aktive Session-Cookie-Authentifizierung.
Query-Parameter und Antwortfelder für GET /api/account/business
Workspace-Slug, dessen Geschäftsprofil abgerufen werden soll.
Gibt an, ob die Anfrage erfolgreich war.
Geschäftsprofil des angegebenen Workspace.
Felder in business
Name des Unternehmens oder Workspace-Profils.
Website des Unternehmens.
Branche des Unternehmens.
Geschäftliche Telefonnummer.
Stadt des Unternehmens.
Bundesland, Region oder Staat des Unternehmens.
Ländercode oder Land des Unternehmens.
Geschäftsprofil aktualisieren
Aktualisieren Sie das Geschäftsprofil eines Workspace über Ihre aktive Session.
Request-Body für PUT /api/account/business
Workspace-Slug, dessen Geschäftsprofil aktualisiert werden soll.
Name des Unternehmens.
Website des Unternehmens.
Branche des Unternehmens.
Geschäftliche Telefonnummer.
Stadt des Unternehmens.
Bundesland, Region oder Staat des Unternehmens.
Ländercode oder Land des Unternehmens.
Sprache aktualisieren
Aktualisieren Sie die Workspace-Sprache auf en oder de. Dieser Endpunkt akzeptiert nur Session-Cookie-Authentifizierung und nur Workspace-Owner dürfen ihn verwenden.
Nur Owner eines Workspace können PUT /api/account/language verwenden.
Request-Body für PUT /api/account/language
Workspace-Slug, dessen Sprache aktualisiert werden soll.
Neue Workspace-Sprache. Zulässige Werte sind en und de.
endeSprache abrufen
Gibt die aktuelle Sprache eines Workspace anhand dessen Slug zurück.
Endpunkt
GET https://app.talkturo.com/api/account/language
Query-Parameter
Workspace-Slug, dessen Sprache abgerufen werden soll.
Antwortfelder
Aktueller Workspace-Sprachcode (en oder de).
Auto-Update-Einstellung umschalten
Schalten Sie die Auto-Update-Einstellung für den authentifizierten Desktop-Benutzer um.
Endpunkt
POST https://app.talkturo.com/api/users/me/auto-update
Body-Parameter
Gibt an, ob automatische Desktop-Updates für den aktuellen Benutzer aktiviert werden sollen.
Antwortfelder
Die aktualisierte Auto-Update-Einstellung des aktuellen Benutzers.
Kontoverifizierungen
Verwalten Sie den Verifizierungsstatus des Kontos und reichen Sie Verifizierungsdaten für Compliance-Zwecke ein.
Verifizierungsstatus abrufen
GET https://app.talkturo.com/api/account/verifications
Gibt den aktuellen Verifizierungsstatus für den authentifizierten Kontext zurück.
Verifizierungsdaten einreichen
POST https://app.talkturo.com/api/account/verifications
Reichen Sie Verifizierungsinformationen für den authentifizierten Kontext ein. Der Request-Body und die Antwort hängen von der Art der eingereichten Verifizierung ab.
Verwandte Ressourcen
Lesen Sie weiter, wenn Sie Desktop-Authentifizierung oder Workspace-Verwaltung im Detail benötigen.