# Olayları web kancası ucuna yeniden gönder

`POST /v1/webhook-endpoints/{endpoint_id}:replay` · izin `webhook-endpoints:write` · bütün planlar

Son 30 gün içinde `[from, to)` aralığındaki olayları yeniden kuyruğa alır; örneğin ucun kapalı kaldığı dönemin olaylarını. `types` daraltmadıkça yalnız ucun olay türleri gönderilir. Yeniden gönderilen her teslim olayın `webhook-id`'sini korur; yinelenenleri `webhook-id` ile ayıklayan alıcı her olayı bir kez işler. Teslimdeki `replay_no` bir artar.

## İstek

| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| `endpoint_id` | yol | evet | Web kancası ucu kimliği (`whe_…`). |
| `from` | date-time | evet | Aralığın başı (dahil); son 30 gün içinde. |
| `to` | date-time | evet | Aralığın sonu (hariç); `from`'dan sonra. |
| `types` | string[] | hayır | Yeniden gönderilecek türler; boş ya da yoksa ucun türleri. |
| `Idempotency-Key` | başlık | hayır | Aynı anahtarla tekrarlanan istekte yanıtı yeniden oynatır, yeniden kuyruğa almaz. |

```json
{
  "from": "2026-10-20T00:00:00Z",
  "to": "2026-10-21T00:00:00Z",
  "types": ["user.created"]
}
```

## Yanıt

Kuyruğa alınan teslim sayısıyla `200 OK`.

```json
{
  "enqueued": 42
}
```

## Hatalar

| HTTP | code | Ne zaman |
|---|---|---|
| 400 | `unknown_field` | Gövdede yukarıda olmayan bir alan var. |
| 404 | `not_found` | Bu ortamda böyle bir uç yok. |
| 415 | `unsupported_media_type` | Gövde yok ya da `application/json` değil. |
| 422 | `validation_failed` | `/from required`, `/to required` ya da aralık kuralı: `to` `from`'dan sonra değil ya da 30 günden eski. |
| 401 | `unauthenticated` | Kimlik bilgisi yok, geçersiz ya da iptal edilmiş. |
| 403 | `insufficient_permissions` | Kimlik bilgisinde `webhook-endpoints:write` yok. |
| 503 | `service_unavailable` | Yeniden gönderim bu bölgede henüz açık değil ya da web kancası yönetimi geçici olarak kullanılamıyor; `Retry-After` süresinden sonra yeniden deneyin. |

## Örnek

```bash
curl -X POST https://api.eu.keenauth.com/v1/webhook-endpoints/whe_01k8a3m5q7t9v1w3x5y7z9b2c4:replay \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7a1c3e5f-9b2d-4f6a-8c0e-2b4d6f8a0c2e" \
  -d '{"from":"2026-10-20T00:00:00Z","to":"2026-10-21T00:00:00Z"}'
```

CLI (gövde standart girdiden ya da dosyadan (`--data @replay.json`) okunur):

```bash
echo '{"from":"2026-10-20T00:00:00Z","to":"2026-10-21T00:00:00Z"}' | keenauth webhook-endpoints replay whe_01k8a3m5q7t9v1w3x5y7z9b2c4 --data -
```