RessourcenBenutzer und Konto

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/me
  • PUT /api/users/me
  • GET /api/users/me/subscription
  • GET /api/users/me/workspaces
  • POST /api/users/me/auto-update

Aktuellen Benutzer abrufen

Rufen Sie das Profil des aktuell authentifizierten Desktop-Benutzers ab.

Antwortfelder von GET /api/users/me

uidstring
Required

Eindeutige Kennung des aktuellen Benutzers.

emailstring
Required

E-Mail-Adresse des aktuellen Benutzers.

display_namestring
Required

Anzeigename des Benutzers.

auto_update_enabledboolean
Required

Gibt an, ob automatische Updates im Desktop-Client aktiviert sind.

has_migrated_to_firebaseboolean
Required

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

body
display_namestring
Required

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

header
Authorizationstring
Required

Bearer-Token des Desktop-Benutzers.

header
X-Talkturo-Accountstring

Optionaler Workspace-Slug, um das Abonnement im Kontext eines bestimmten Workspace abzurufen.

successboolean
Required

Gibt an, ob die Anfrage erfolgreich verarbeitet wurde.

hasActiveSubscriptionboolean
Required

Gibt an, ob für den aktuellen Benutzer oder den angegebenen Workspace ein aktives Abonnement vorliegt.

dataobject
Required

Enthält die Abonnementdetails, Limits und Nutzungswerte.

Felder in data

activeboolean
Required

Gibt an, ob das Abonnement aktuell aktiv ist.

planstring
Required

Planname des aktiven Abonnements.

sourcestring
Required

Quelle des Abonnements, zum Beispiel ein externer Billing-Anbieter.

current_period_endstring
Required

Zeitpunkt, an dem der aktuelle Abrechnungszeitraum endet.

trial_ends_atstring

Zeitpunkt, an dem eine Testphase endet, falls vorhanden.

account_idstring
Required

Eindeutige Kennung des Workspace-Kontos.

account_slugstring
Required

Slug des Workspace-Kontos.

access_blocked_reasonstring

Grund für einen gesperrten Zugriff, falls der Zugriff auf das Abonnement oder den Workspace eingeschränkt ist.

limitsobject
Required

Abonnementlimits für Plätze, Anrufe und verfügbare Funktionen.

usageobject
Required

Aktuelle Nutzung im laufenden Zeitraum.

Felder in limits

seatsnumber
Required

Maximale Anzahl an Benutzerplätzen.

calls_per_monthnumber
Required

Maximale Anzahl an Anrufen pro Monat.

session_max_minutesnumber
Required

Maximale Sitzungsdauer in Minuten.

retention_daysnumber
Required

Anzahl der Tage, für die Daten aufbewahrt werden.

sales_modesboolean
Required

Gibt an, ob vertriebsbezogene Modi im Plan enthalten sind.

Felder in usage

calls_this_monthnumber
Required

Bisher verbrauchte Anrufe im aktuellen Monat.

calls_limitnumber
Required

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

successboolean
Required

Gibt an, ob die Anfrage erfolgreich war.

workspacesarray
Required

Liste aller Workspaces, auf die der aktuelle Benutzer zugreifen kann.

Felder pro Workspace

account_idstring
Required

Eindeutige Konto-ID des Workspace.

slugstring
Required

Slug des Workspace.

namestring
Required

Anzeigename des Workspace.

is_personal_accountboolean
Required

Gibt an, ob es sich um einen persönlichen Workspace handelt.

rolestring
Required

Rolle des aktuellen Benutzers in diesem Workspace.

has_desktop_planboolean
Required

Gibt an, ob für den Workspace ein Desktop-Plan hinterlegt ist.

has_desktop_accessboolean
Required

Gibt an, ob der aktuelle Benutzer Desktop-Zugriff für diesen Workspace hat.

planstring
Required

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

query
accountstring
Required

Workspace-Slug, dessen Geschäftsprofil abgerufen werden soll.

successboolean
Required

Gibt an, ob die Anfrage erfolgreich war.

businessobject
Required

Geschäftsprofil des angegebenen Workspace.

Felder in business

business_namestring
Required

Name des Unternehmens oder Workspace-Profils.

business_websitestring
Required

Website des Unternehmens.

business_industrystring
Required

Branche des Unternehmens.

business_phonestring
Required

Geschäftliche Telefonnummer.

business_citystring
Required

Stadt des Unternehmens.

business_statestring
Required

Bundesland, Region oder Staat des Unternehmens.

business_countrystring
Required

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

body
accountstring
Required

Workspace-Slug, dessen Geschäftsprofil aktualisiert werden soll.

body
businessNamestring
Required

Name des Unternehmens.

body
businessWebsitestring
Required

Website des Unternehmens.

body
businessIndustrystring
Required

Branche des Unternehmens.

body
businessPhonestring
Required

Geschäftliche Telefonnummer.

body
businessCitystring
Required

Stadt des Unternehmens.

body
businessStatestring
Required

Bundesland, Region oder Staat des Unternehmens.

body
businessCountrystring
Required

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

body
accountstring
Required

Workspace-Slug, dessen Sprache aktualisiert werden soll.

body
languagestring
Required

Neue Workspace-Sprache. Zulässige Werte sind en und de.

Allowed values:ende

Sprache abrufen

Gibt die aktuelle Sprache eines Workspace anhand dessen Slug zurück.

Endpunkt

GET https://app.talkturo.com/api/account/language

Query-Parameter

query
accountstring
Required

Workspace-Slug, dessen Sprache abgerufen werden soll.

Antwortfelder

languagestring
Required

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

body
auto_update_enabledboolean
Required

Gibt an, ob automatische Desktop-Updates für den aktuellen Benutzer aktiviert werden sollen.

Antwortfelder

auto_update_enabledboolean
Required

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.