Guthaben

curl -X GET "https://api.talkturo.com/api/credits?accountId=acc_7f2c91d8-3b31-4b4d-bf80-5c6f11a2d931" \
  -H "Authorization: Bearer tk_live_example_9xmk7q2r"

const response = await fetch(
  "https://api.talkturo.com/api/credits?accountId=acc_7f2c91d8-3b31-4b4d-bf80-5c6f11a2d931",
  {
    method: "GET",
    headers: {
      Authorization: "Bearer tk_live_example_9xmk7q2r"
    }
  }
);

const data = await response.json();
console.log(data);

{
  "success": true,
  "credits": {
    "id": "cred_4a8d6f12",
    "account_id": "acc_7f2c91d8-3b31-4b4d-bf80-5c6f11a2d931",
    "credits": 18420,
    "total_purchased": 25000,
    "total_used": 6580,
    "auto_reload_enabled": true,
    "auto_reload_threshold": 2000,
    "auto_reload_amount_usd": 199
  }
}

curl -X POST "https://api.talkturo.com/api/credits" \
  -H "Authorization: Bearer tk_live_example_9xmk7q2r" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_7f2c91d8-3b31-4b4d-bf80-5c6f11a2d931",
    "amount": 120,
    "description": "Outbound call usage",
    "metadata": {
      "assistantId": "asst_b83bde21",
      "callId": "call_91fd2e74"
    }
  }'

const response = await fetch("https://api.talkturo.com/api/credits", {
  method: "POST",
  headers: {
    Authorization: "Bearer tk_live_example_9xmk7q2r",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    accountId: "acc_7f2c91d8-3b31-4b4d-bf80-5c6f11a2d931",
    amount: 120,
    description: "Outbound call usage",
    metadata: {
      assistantId: "asst_b83bde21",
      callId: "call_91fd2e74"
    }
  })
});

const data = await response.json();
console.log(data);

{
  "success": true,
  "transactionId": "txn_6c1f3ab9",
  "balance": 18300,
  "autoReloadTriggered": false
}

{
  "success": false,
  "error": "Insufficient credits"
}

curl -X POST "https://api.talkturo.com/api/credits/checkout" \
  -H "Authorization: Bearer tk_live_example_9xmk7q2r" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_7f2c91d8-3b31-4b4d-bf80-5c6f11a2d931",
    "accountSlug": "acme-sales",
    "planId": "credits_growth_199",
    "customerEmail": "finance@acme-sales.com"
  }'

const response = await fetch("https://api.talkturo.com/api/credits/checkout", {
  method: "POST",
  headers: {
    Authorization: "Bearer tk_live_example_9xmk7q2r",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    accountId: "acc_7f2c91d8-3b31-4b4d-bf80-5c6f11a2d931",
    accountSlug: "acme-sales",
    planId: "credits_growth_199",
    customerEmail: "finance@acme-sales.com"
  })
});

const data = await response.json();
console.log(data);

{
  "success": true,
  "checkoutToken": "seti_example_7b34f2c8",
  "sessionId": "cs_test_b1a92c7d5e",
  "credits": 20000,
  "amount": 199
}

Guthaben für Ihr Konto verwalten

Mit den Guthaben-Endpunkten prüfen Sie Ihren aktuellen Kontostand, ziehen Nutzungsguthaben ab, starten den Kauf zusätzlicher Credits und rufen verlaufsbezogene Daten ab. Die API deckt sowohl programmgesteuerte Nutzungsvorgänge als auch abrechnungsnahe Workflows wie Checkout und Auto-Reload ab.

Ein Teil dieser Endpunkte verwendet Dual-Auth über withApiAuth. Sie können diese Endpunkte entweder mit einem API-Schlüssel oder mit einer bestehenden Sitzung aufrufen. Andere Endpunkte sind ausschließlich für authentifizierte Sitzungen verfügbar und eignen sich vor allem für Dashboard-nahe Abläufe.

Endpunkte im Überblick

Guthabenstand abrufen

Rufen Sie den aktuellen Guthabenstand eines Kontos mit GET /api/credits ab. Wenn für das angegebene Konto noch kein Guthabeneintrag existiert, erstellt der Endpunkt ihn automatisch.

Query-Parameter

Antwortfelder

Guthaben abziehen

Verwenden Sie POST /api/credits, um Guthaben für Nutzungsvorgänge zu verbuchen. Der Endpunkt führt die Abbuchung serverseitig aus und gibt den aktualisierten Saldo sowie Informationen zu einem möglichen Auto-Reload zurück.

Body-Parameter

Antwortfelder

Checkout für Guthabenkauf erstellen

Erstellen Sie mit POST /api/credits/checkout eine Stripe-Checkout-Sitzung für den Kauf zusätzlicher Credits. Sie übergeben entweder eine planId oder ein benutzerdefiniertes Paar aus Betrag und Guthabenmenge.

Body-Parameter

Antwortfelder

Nur für Sitzungen verfügbare Endpunkte

Die folgenden Guthaben-Endpunkte unterstützen keinen API-Schlüssel. Rufen Sie sie nur aus einem angemeldeten Benutzerkontext auf.

Verwandte Seiten