Use cases

Workbench bietet viele Tools für Entwickler/innen, um ihre Stripe-Integration zu debuggen, zu verwalten und zu erweitern. Diese Anleitungen helfen Ihnen zu verstehen, wie Sie gängige Entwickleraufgaben erfüllen können.

Von API-Anfragen verwendete API-Versionen 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 Ihres Kontos.

1. Öffnen Sie die Registerkarte Übersicht in Workbench.
2. Überprüfen Sie den Abschnitt API-Versionen, um Anfragen zu sehen, die in der letzten Woche gestellt wurden.
3. Die standardmäßige API-Version Ihres Kontos zeigt die Bezeichnung auf.

Eine Liste der Versionen finden Sie im API-Änderungsprotokoll

Kürzliche Integrationsfehler anzeigen

Stripe gruppiert die letzten Integrationsfehler automatisch nach Fehlertyp und Endpoint.

1. Öffnen Sie die Registerkarte Fehler in Workbench.
2. Wählen Sie im Bereich Letzte Fehler den Zeitraum aus, nach dem Fehler gefiltert werden sollen.
3. Klicken Sie auf eine Fehlergruppe, um die Zusammenfassung mit einer Beschreibung der Häufigkeit, des API-Endpoints und der Anfragequelle anzuzeigen.

Anzeigen von API-Anfrageprotokollen nach HTTP-Methode oder Status

Mit diesen Schritten können Sie API-Anfrageprotokolle nach HTTP-Methode oder Status filtern.

1. Öffnen Sie die Registerkarte Protokolle in Workbench.
2. Klicken Sie auf Status, um nach erfolgreichen oder fehlgeschlagenen Anfragen zu filtern. (Siehe die vollständige Liste der HTTP-Statuscodes, die Stripe zurückgibt.)
3. Klicken Sie auf Anwenden.

API-Anfrageprotokolle nach Quelle anzeigen

Filtern Sie mithilfe dieser Schritte API-Anfrageprotokolle nach Quelle. API-Anfragen können entweder durch Aktionen im Dashboard oder durch einen direkten API-Aufruf (z. B. mithilfe eines SDK) entstehen.

1. Öffnen Sie die Registerkarte Protokolle in Workbench.
2. Klicken Sie auf Weitere Filter.
3. Wählen Sie unter Quelle die Option Dashboard oder API aus, um Anfragen nach Quelle zu filtern.
4. Klicken Sie auf Anwenden.

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-Feld) wie beispielsweise cus_ImZZa3EEvvQQQU zurück. Filtern Sie mit diesen Schritten API-Anfragen nach Ressourcen-ID.

1. Öffnen Sie die Registerkarte Protokolle in Workbench.
2. Geben Sie die Ressourcen-ID in das Textfeld Nach Ressourcen-ID filtern ein und drücken Sie auf Ihrer Tastatur die Eingabetaste.

Ereignisse filtern

Mit den folgenden Schritten können Sie Ereignisse und deren Ereignisobjektnutzlast anzeigen.

1. Öffnen Sie die Registerkarte Ereignisse in Workbench.
2. Um nach Ereignis zu filtern, klicken Sie auf Ereignistyp:
   • Geben Sie einen Ereignisnamen ein. Zum Beispiel payment_intent.created.
   • Geben Sie ein Ereignis mit dem Platzhalterzeichen ein. Zum Beispiel payment_intent.*.
3. Klicken Sie auf Anwenden.

View errors for a workflow run

You can use Workbench to inspect a workflow run. Click a step in the workflow in the Dashboard to see details, or open it in Workbench for inspection. To learn more, see Set up a workflow.