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 ile silme 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 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ı. 
{
  "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

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