Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellenAnmelden
Jetzt starten
Zahlungen
Umsatz
Plattformen und Marktplätze
Geldmanagement
Entwicklerressourcen
APIs und SDKsHilfe
Übersicht
Versionierung
Änderungsprotokoll
    Übersicht
    Clover
    Basil
    Acacia
    Vorherige Versionen
Aktualisieren Sie Ihre API-Version
Ihre SDK-Version aktualisieren
Essentials
SDKs
API
Tests
Stripe-CLI
Beispiel-Projekte
Tools
Stripe Dashboard
Workbench
Entwickler-Dashboard
Stripe für Visual Studio Code
Terraform
Funktionen
Arbeitsabläufe
Ereignisziele
Stripe-StatuswarnungenHochgeladene Dateien
KI-Lösungen
Agent-Toolkit
Model Context ProtocolAgentische KI-SaaS-Billing-Workflows aufbauen
Sicherheit und Datenschutz
Sicherheit
Stripebot-Webcrawler
Stripe erweitern
Erstellen Sie Stripe-Apps
Verwenden Sie Apps von Stripe
Partner
Partner-Ecosystem
Partner-Zertifizierung
Vereinigte Staaten
Deutsch
StartseiteEntwicklerressourcenChangelogBasil2025-03-31.basil

Hinweis

Bis jetzt ist diese Seite noch nicht in dieser Sprache verfügbar. Wir arbeiten aber verstärkt daran, unsere Dokumentation in weiteren Sprachen bereitzustellen, und werden die Übersetzung sofort anzeigen, sobald diese verfügbar ist.

Die Erweiterung der Gesamtzahl für Listenmethoden der API wird entferntWichtige Änderungen

Das ändert sich

Die Eigenschaft total_count kann in Listen nicht mehr erweitert werden. Neue Nutzer/innen können total_count in älteren Stripe-Versionen nicht erweitern. Beim Versuch, total_count zu erweitern, wird der Fehler 400 mit der Fehlermeldung property_forbidden zurückgegeben.

Warum ist dies eine wichtige Änderung?

Für die API-Methoden „list“ sind keine Anfragen für die Erweiterung total_count zulässig. Um diese Version zu verwenden, müssen Sie Ihre Integration so umstellen, dass Sie sich ausschließlich auf das Listen-Antwortfeld has_more stützt.

Ergebnis

Wenn Ihre Integration total_count für die Paginierung verwendet und die API-Parameter include[]=total_count oder exclude[]=total_count mit Ihrer API-Anfrage übermittelt, müssen Sie Ihre Paginierungsintegration aktualisieren, sodass sie sich ausschließlich auf das Antwortfeld has_more stützt.

Einige API-Ressourcen der obersten Ebene geben für einige ihrer Listenfelder immer total_count-Werte zurück. Sie bemerken dies möglicherweise, wenn Sie Ihrer Anfrage weder include[]=total_count noch exclude[]=total_count hinzufügen, aber dennoch total_count-Daten als Teil der Antwort erhalten. Diese API-Ressourcen sind von dieser Versionsänderung nicht betroffen.

Upgrade

  1. Zeigen Sie Ihre aktuelle API-Version in Workbench an.
  2. Wenn Sie ein SDK verwenden, aktualisieren Sie auf die entsprechende SDK-Version für diese API-Version.
    • Wenn Sie kein SDK verwenden, aktualisieren Sie Ihre API-Anfragen auf Stripe-Version: 2025-03-31.basil
  3. Aktualisieren Sie die für Webhook-Endpoints verwendete API-Version.
  4. Testen Sie Ihre Integration mit der neuen Version.
  5. Wenn Sie Connect verwenden, testen Sie Ihre Connect-Integration.
  6. Führen Sie das Upgrade in Workbench durch. Sie können die Version für 72 Stunden zurücksetzen.

Erfahren Sie mehr über Stripe-API-Upgrades.

War diese Seite hilfreich?
JaNein
  • Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
  • Schauen Sie sich unser Änderungsprotokoll an.
  • Fragen? Sales-Team kontaktieren.
  • LLM? Lesen Sie llms.txt.
  • Unterstützt von Markdoc