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
Datenschutz
Stripe erweitern
Erstellen Sie Stripe-Apps
Verwenden Sie Apps von Stripe
Partner
Partner-Ecosystem
Partner-Zertifizierung
Vereinigte Staaten
Deutsch
StartseiteEntwicklerressourcenChangelogClover2025-11-17.preview

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 Meter Usage Analytics bieten nun Unterstützung für das Filtern mehrerer Mandanten und Dimensionswerte.Wichtige Änderungen

Das ändert sich

Aktualisiert die Parameter tenant_filters und dimension_filters in der Meter Usage Analytics API, sodass sie anstelle einzelner Zeichenfolgenwerte ein Array von Zeichenfolgen akzeptieren. Diese Änderung ermöglicht es, Nutzungsdaten über mehrere Mandanten- oder Dimensionswerte hinweg mit einem einzigen API-Aufruf zu filtern.

Bisher akzeptierte jeder Filterparameter nur einen einzigen Zeichenfolgenwert, sodass mehrere API-Aufrufe erforderlich waren, um Nutzung für verschiedene Mandanten- oder Dimensionskombinationen abzurufen.

Warum ist dies eine wichtige Änderung?

Bestehende Integrationen, die einzelne Zeichenfolgenwerte übergeben, erhalten Validierungsfehler, bis sie so aktualisiert werden, dass sie das Array-Format verwenden. Diese grundlegende Änderung ermöglicht flexiblere Filterfunktionen, die die gleichzeitige Abfrage von Nutzungsdaten über mehrere Werte hinweg unterstützen und so die Anzahl der API-Aufrufe reduzieren, die für komplexe Szenarien der Nutzungsberichterstattung erforderlich sind.

Auswirkungen

Sie müssen Ihre Integration aktualisieren, damit beim Aufruf von Analysen der gemessenen Nutzung von Zählern Arrays von Zeichenfolgen für die Parameter tenant_filters und dimension_filters übergeben werden. Wenn Ihre Integration derzeit einzelne Zeichenfolgenwerte übergibt, müssen Sie diese in Arrays einbetten.

Änderungen

FeldÄndernVon → bis
Billing.Analytics.MeterUsage#retrieve.meters[].dimension_filtersGeändert
string → array(string)string → array(string)

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-11-17.preview
  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