# Bir webhook uç noktasını alın

`GET /v1/webhook-endpoints/{endpoint_id}` · İzin `webhook-endpoints:read` · tüm planlar

Bir webhook uç noktasını döndürür. `ETag` üstbilgisi, uç noktanın sürümüdür ve [güncelleme](update.md) ile [silme](delete.md) işlemleri için `If-Match` değeridir. İmzalama sırrı burada hiçbir zaman döndürülmez.

## İstek

| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| `endpoint_id` | path | evet | Webhook uç noktası kimliği (`whe_…`). |

## Yanıt

`200 OK` ile uç nokta.

| Alan | Açıklama |
|---|---|
| `id` | Uç nokta kimliği (`whe_…`). |
| `key` | Kararlı anahtar, ortamda benzersiz. |
| `url` | Alıcı URL'si. |
| `description` | Serbest metin; yoksa boş dize. |
| `event_types` | Seçilen katalog olay türleri; boş ise yoğun hacimli olanlar dışındaki tüm türler anlamına gelir. |
| `event_schema_versions` | Olay türü → şema sürümü geçersiz kılmaları. |
| `payload_mode` | `thin` veya `full`. |
| `status` | `enabled`, `disabled_by_user`, `disabled_by_failure` (5 gün boyunca başarılı teslimat yok ve en az 10 terk edilmiş teslimat) veya `disabled_by_receiver` (alıcı `410 Gone` yanıtı verdi). [Güncelleme](update.md) ile ve `"status": "enabled"` kullanarak yeniden etkinleştirin; devre dışı kalınan dönemin olayları için yeniden oynatmayı kullanın. |
| `rate_limit_per_second` | Bu uç nokta için teslimat hız sınırı. |
| `previous_secret_expires_at` | Rotasyondan sonra, eski sırrın teslimatları hâlâ imzaladığı dönemin sonu; aksi halde `null`. |
| `last_success_at` | Son başarılı teslimat veya `null`. |
| `failing_since` | Kesintisiz başarısız teslimatların başlangıcı veya `null`. |
| `version` | Sürüm; `ETag` üstbilgisine eşittir. |
| `created_at`, `updated_at` | Zaman damgaları. |

```json
{
  "id": "whe_01k8a3m5q7t9v1w3x5y7z9b2c4",
  "key": "crm-sync",
  "url": "https://hooks.example.com/keenauth",
  "description": "CRM sync",
  "event_types": ["user.created", "user.updated"],
  "event_schema_versions": {"user.created": 1},
  "payload_mode": "thin",
  "status": "enabled",
  "rate_limit_per_second": 50,
  "previous_secret_expires_at": null,
  "last_success_at": "2026-10-26T09:12:00Z",
  "failing_since": null,
  "version": 3,
  "created_at": "2026-10-26T09:00:00Z",
  "updated_at": "2026-10-26T10:00:00Z"
}
```

## Hatalar

| HTTP | code | Ne zaman |
|---|---|---|
| 404 | `not_found` | Bu ortamda böyle bir uç nokta yok (başka bir ortamın uç noktası veya hatalı biçimli bir kimlik için de geçerli). |
| 401 | `unauthenticated` | Kimlik bilgisi eksik, geçersiz veya iptal edilmiş. |
| 403 | `insufficient_permissions` | Kimlik bilgisinde `webhook-endpoints:read` yok. |
| 429 | `rate_limited` | Hız sınırı aşıldı; `Retry-After` süresinden sonra yeniden deneyin. |
| 503 | `service_unavailable` | Webhook yönetimi geçici olarak kullanılamıyor; `Retry-After` süresinden sonra yeniden deneyin. |

## Örnek

```bash
curl -i https://api.eu.keenauth.com/v1/webhook-endpoints/whe_01k8a3m5q7t9v1w3x5y7z9b2c4 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

CLI: `keenauth webhook-endpoints get whe_01k8a3m5q7t9v1w3x5y7z9b2c4`