API-Anfrage-Logs anzeigen
Filtern Sie API-Anfrage-Logs und zeigen Sie Log-Einträge im Entwickler-Dashboard an.
Notiz
Workbench ersetzt das Entwickler-Dashboard und wird von uns standardmäßig automatisch für alle neuen Stripe-Konten aktiviert. Konfigurieren Sie diese Einstellung in den Einstellungen für Entwickler/innen im Dashboard.
Erfahren Sie, wie Sie API-Anfragenprotokolle in Workbench anzeigen.
Wenn Sie eine API-Anfrage senden, erstellt Stripe ein Objekt und zeichnet die Anfrage für Ihr Konto auf. Auf dieser Seite wird beschrieben, wie API-Anfrage-Logs gefiltert werden und wie Log-Einträge für Ihr Konto im Entwickler-Dashboard angezeigt werden.
So werden Anfragen aufgezeichnet
Diese Tabelle beschreibt die verschiedenen Möglichkeiten, wie Stripe eine API-Anfrage für Ihr Konto aufzeichnet.
| Quelle | API-Aufruf | Protokolle |
|---|---|---|
| API | Wenn Sie ein Ereignis manuell mit der Stripe-CLI auslösen. | Protokolliert den API-Aufruf auf der Seite Protokolle. |
| API | Wenn Nutzeraktionen in Ihrer App oder Website in einem API-Aufruf resultieren. | Protokolliert den API-Aufruf auf der Seite Protokolle. |
| API | Wenn Sie eine API direkt mit der Stripe-CLI aufrufen. | Protokolliert den API-Aufruf auf der Seite Protokolle. |
| Dashboard | Wenn Sie eine API aufrufen, indem Sie Ihre Stripe-Ressourcen im Dashboard ändern. | Protokolliert den API-Aufruf auf der Seite Protokolle. |
Ihre Standard-API-Version anzeigen
Wenn Sie Anfragen an Stripe senden, können Sie eine API-Version mit dem Header Stripe-Version angeben. Wenn Sie keine API-Version angeben, verwendet Stripe die Standard-API-Version für Ihr Konto. Mit diesen Schritten können Sie alle API-Versionen finden, die innerhalb der letzten Woche von Ihrem Konto verwendet wurden. Wenn Sie die neueste API-Version verwenden, ist die Version mit Latest gekennzeichnet.
- Öffnen Sie das Entwickler-Dashboard.
- Die standardmäßige API-Version Ihres Kontos hat die Bezeichnung
Default.
Eine Liste der Versionen finden Sie im API-Änderungsprotokoll.
API-Anfragen nach Quelle anzeigen
Filtern Sie mit diesen Schritten Anfragen nach der Quelle eines API-Aufrufs.
- Öffnen Sie die Seite Logs.
- Klicken Sie auf Mehr.
- Wählen Sie unter Quelle die Option Dashboard oder API aus, um Anfragen nach Quelle zu filtern.
- Klicken Sie auf Anwenden.
Häufige Integrationsfehler finden
Verwenden Sie diesen Filter, um häufige Integrationsfehler nach Fehlercode und API-Endpoint zu ermitteln.
- Öffnen Sie das Entwickler-Dashboard.
- Wählen Sie unter Letzte Fehler die Filterschaltfläche () aus.
- Wählen Sie einen Fehlertyp aus.
- Klicken Sie auf einen Fehler, um die Nutzlast der fehlgeschlagenen Anfrage und den Grund dafür anzuzeigen.
Nach Ressourcen-ID filtern
Wenn Sie eine Stripe-Ressourcen mit Stripe-APIs erstellen, aktualisieren oder löschen, gibt Stripe eine Ressourcen-ID in der Nutzlast der Antwort zurück. Wenn Sie beispielsweise einen Kunden/eine Kundin erstellen, gibt Stripe eine Kunden-ID (in id) wie beispielsweise cus_ zurück. Filtern Sie mit diesen Schritten API-Anfragen nach Ressourcen-ID.
- Öffnen Sie die Seite Logs.
- Geben Sie die Ressourcen-ID in das Textfeld Nach Ressourcen-ID filtern ein.
Erweiterte Filter anwenden
Mit der Inline-Navigation können Sie API-Anfragen nach Datum, Status, Methode und API-Endpoint filtern oder weitere Filter zur Fehlerbehebung bei Anfragen verwenden. Filtern Sie mit diesen Schritten API-Anfragen nach API-Version, Fehlertyp, Fehlercode und anderen Filtern wie beispielsweise einer IP-Adresse.
- Öffnen Sie die Seite Logs.
- Klicken Sie auf Mehr.
- Um nach Version zu filtern, wählen Sie eine Option im Dropdown-Menü API-Version aus. Beispiel:
2025-04-30..basil - Um nach Fehlertyp zu filtern, wählen Sie eine Option im Dropdown-Menü Fehlertyp aus. Beispiel:
card_.error - Um nach Fehlermeldung zu filtern, wählen Sie eine Option im Dropdown-Menü Fehlercode aus. Beispiel:
bank_.account_ unverified
- Um nach Version zu filtern, wählen Sie eine Option im Dropdown-Menü API-Version aus. Beispiel:
- Klicken Sie auf Anwenden.
