Webhooks

Zustellungen auflisten

Ruft die Zustellversuche eines Webhook-Endpoints seitenweise ab. Filtern Sie nach Status, um erfolgreiche von fehlgeschlagenen oder ausstehenden Zustellungen zu trennen.

GEThttps://graph.sendcorex.com/v3.0/webhooks/:id/deliveries

Parameter

  • idstringerforderlich

    Pfadparameter. ID des Webhook-Endpoints.

    z. B. "wh_123"

  • statusstringoptional

    Query-Parameter. delivered oder failed (failed umfasst auch ausstehende). Weglassen für alle.

    z. B. "failed"

  • pagenumberoptional

    Query-Parameter. Seitennummer. Standard 1.

    z. B. 1

  • limitnumberoptional

    Query-Parameter. Ergebnisse pro Seite. Standard 20, maximal 50.

    z. B. 20

Schnellstart

import axios from 'axios';

const response = await axios.get('https://graph.sendcorex.com/v3.0/webhooks/wh_123/deliveries?status=failed&page=1&limit=20', {
  headers: { Authorization: process.env.SENDCOREX_API_KEY },
});

console.log(response.data);

Antwort

{
  "success": true,
  "deliveries": [
    {
      "id": "del_9f3a",
      "event": "bounced",
      "status": "failed",
      "httpStatus": 500,
      "responseBody": "Internal Server Error",
      "attemptNumber": 3,
      "nextRetryAt": null,
      "createdAt": "2026-08-08T14:22:00.000Z"
    }
  ],
  "total": 47,
  "page": 1,
  "limit": 20,
  "responseTime": "38ms"
}

Antwortfelder

  • deliveries[].id

    ID der Zustellung. Übergeben Sie sie an Zustellung erneut senden.

  • deliveries[].event

    Das Event, das zugestellt werden sollte, zum Beispiel bounced.

  • deliveries[].status

    Zustellstatus, zum Beispiel failed.

  • deliveries[].httpStatus

    HTTP-Status, mit dem Ihr Server geantwortet hat.

  • deliveries[].responseBody

    Body, mit dem Ihr Server geantwortet hat.

  • deliveries[].attemptNumber

    Wie viele Versuche unternommen wurden.

  • deliveries[].nextRetryAt

    Wann der nächste Versuch geplant ist, oder null.

  • deliveries[].createdAt

    Zeitstempel im ISO-8601-Format.

  • total / page / limit

    Angaben zur Paginierung.

Fehler

Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.

  • 401INVALID_API_KEY

    Der API key ist ungültig oder wurde widerrufen.