Web kancası ucunun teslimlerini listele

GET /v1/webhook-endpoints/{endpoint_id}/deliveries · izin webhook-endpoints:read · bütün planlar

Ucun son 30 günlük teslim geçmişini yeniden eskiye (order=asc ile eskiden yeniye) imleçli sayfalarla döndürür. Yalnız meta veri döner: ne yük ne de alıcının yanıt gövdesi listede tutulur. İmleç uca ve status, event_type süzgeçlerine bağlıdır.

İstek

Alan	Tür	Zorunlu	Açıklama
`endpoint_id`	yol	evet	Web kancası ucu kimliği (`whe_…`).
`status`	sorgu	hayır	`pending`, `retrying`, `succeeded`, `abandoned` ya da `cancelled`.
`event_type`	sorgu	hayır	Yalnız bu olay türündeki teslimler.
`limit`	sorgu	hayır	1–100, varsayılan 20.
`after`, `before`	sorgu	hayır	`list_metadata`'daki imleç.
`order`	sorgu	hayır	`desc` (varsayılan) ya da `asc`.

Yanıt

200 OK

{
  "data": [
    {
      "id": "whd_01k8a3m6r8t0v2w4x6y8z0b3d5",
      "endpoint_id": "whe_01k8a3m5q7t9v1w3x5y7z9b2c4",
      "event_id": "evt_01k8a3m7s9v1w3x5y7z9b2c4d6",
      "event_seq": 1042,
      "event_type": "user.created",
      "replay_no": 0,
      "status": "abandoned",
      "attempt_count": 8,
      "next_attempt_at": null,
      "last_http_status": 500,
      "last_error_class": "http_status",
      "last_latency_ms": 312,
      "created_at": "2026-10-25T08:00:00Z",
      "completed_at": "2026-10-26T08:00:00Z"
    }
  ],
  "list_metadata": { "before": null, "after": "eyJ2IjoxLCJ…" }
}

Hatalar

HTTP	code	Ne zaman
400	`invalid_cursor`	İmleç bozuk ya da başka bir uca, süzgece veya sıraya ait.
404	`not_found`	Bu ortamda böyle bir uç yok.
422	`validation_failed`	`/status invalid_value`, `/event_type invalid_value`, yinelenen parametre ya da 1–100 dışında `limit`.
401	`unauthenticated`	Kimlik bilgisi yok, geçersiz ya da iptal edilmiş.
403	`insufficient_permissions`	Kimlik bilgisinde `webhook-endpoints:read` yok.
503	`service_unavailable`	Web kancası yönetimi geçici olarak kullanılamıyor; `Retry-After` süresinden sonra yeniden deneyin.

Örnek

curl "https://api.eu.keenauth.com/v1/webhook-endpoints/whe_01k8a3m5q7t9v1w3x5y7z9b2c4/deliveries?status=abandoned&limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth webhook-endpoints deliveries list whe_01k8a3m5q7t9v1w3x5y7z9b2c4 --status abandoned --limit 20