POST AI agent ready /v1/webhook/inbox/:id/list

Webhook Payload List API – Kostenloser Inbox Viewer

Rufen Sie jede von einem Webhook-Posteingang erfasste Nutzlast ab, einschließlich des Anforderungstexts, des Zeitstempels und einer eindeutigen Nutzlast-ID. Gibt bis zu 50 der neuesten Nutzlasten zurück. Der Posteingang muss über den Endpunkt /v1/webhook/inbox/create erstellt worden sein.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/webhook/inbox/:id/list \
  -H "Content-Type: application/json" \
  -d '{"id":"a1b2c3d4"}'

When to use this API

Überprüfen Sie die genaue Nutzlaststruktur, die ein Webhook-Anbieter sendet

Nachdem Sie ein Testereignis ausgelöst haben, listen Sie die Posteingangsnutzlasten auf, um den rohen JSON-Text anzuzeigen. Verwenden Sie dies, um typisierte Schnittstellen für Ihren Webhook-Handler zu erstellen, ohne das Schema zu erraten.

Stellen Sie sicher, dass Ihr Webhook-Forwarder die Nutzdaten korrekt weiterleitet

Wenn Sie Webhooks über einen Proxy oder eine Warteschlange weiterleiten, verweisen Sie die Proxy-Ausgabe auf einen Test-Posteingang. Vergleichen Sie die aufgelisteten Nutzlasten mit den Nutzlasten des ursprünglichen Anbieters, um sicherzustellen, dass nichts geändert wurde.

Erstellen Sie automatisierte Integrationstests für Webhook-Konsumenten

Erstellen Sie einen Posteingang in Ihrer Testsuite, senden Sie eine simulierte Webhook-Nutzlast und rufen Sie dann den Listenendpunkt auf, um zu bestätigen, dass die Nutzlast angekommen ist. Keine Scheinserver erforderlich.

Frequently asked questions

Was passiert, wenn die Posteingangs-ID nicht existiert oder abgelaufen ist?

Die API gibt einen 404-Fehler mit dem Code INBOX_NOT_FOUND zurück. Erstellen Sie einen neuen Posteingang, wenn Ihr Posteingang abgelaufen ist.

Werden die Nutzlasten in chronologischer Reihenfolge zurückgegeben?

Ja. Die Nutzlasten werden nach dem Zeitstempel „receive_at“ sortiert, die ältesten zuerst. Die letzten 50 Nutzlasten sind enthalten.

Kann ich einzelne Payloads aus einem Posteingang löschen?

Nein. Payloads können nicht einzeln gelöscht werden. Sie verfallen automatisch mit dem Posteingang nach 24 Stunden.

Gibt dieser Endpunkt den vollständigen Nutzlastkörper zurück?

Ja. Der vollständige JSON-Text, der an die Empfangs-URL des Posteingangs gesendet wird, wird im Textfeld jedes Nutzdateneintrags gespeichert und zurückgegeben.

Wird die Posteingangs-ID in der URL oder im Anfragetext übergeben?

Die Posteingangs-ID wird im URL-Pfad übergeben: /v1/webhook/inbox/{id}/list. Der Anfragetext kann leer sein.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.