Obtenir un point de terminaison webhook

GET /v1/webhook-endpoints/{endpoint_id} · autorisation webhook-endpoints:read · tous les forfaits

Renvoie un point de terminaison webhook. L'en-tête ETag correspond à la version du point de terminaison et à la valeur If-Match pour la mise à jour et la suppression. Le secret de signature n'est jamais renvoyé ici.

Requête

Champ Type Obligatoire Description
endpoint_id path oui Identifiant du point de terminaison webhook (whe_…).

Réponse

200 OK avec le point de terminaison.

Champ Description
id Identifiant du point de terminaison (whe_…).
key Clé stable, unique dans l'environnement.
url URL du récepteur.
description Texte libre ; chaîne vide si absent.
event_types Types d'événements du catalogue sélectionnés ; vide signifie tous les types, à l'exception des types à fort volume.
event_schema_versions Substitutions de version de schéma par type d'événement.
payload_mode thin ou full.
status enabled, disabled_by_user, disabled_by_failure (aucune livraison réussie pendant 5 jours et au moins 10 livraisons abandonnées) ou disabled_by_receiver (le récepteur a répondu 410 Gone). Réactivez avec la mise à jour et "status": "enabled" ; utilisez le rejeu pour les événements de la période désactivée.
rate_limit_per_second Plafond de débit des livraisons pour ce point de terminaison.
previous_secret_expires_at Après une rotation, la fin de la période pendant laquelle l'ancien secret signe encore les livraisons ; sinon null.
last_success_at Dernière livraison réussie, ou null.
failing_since Début des livraisons en échec consécutives, ou null.
version Version ; égale à l'en-tête ETag.
created_at, updated_at Horodatages. 
{
  "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"
}

Erreurs

HTTP code Quand
404 not_found Aucun point de terminaison de ce type dans cet environnement (également pour le point de terminaison d'un autre environnement ou un identifiant mal formé).
401 unauthenticated L'identifiant est absent, invalide ou révoqué.
403 insufficient_permissions L'identifiant ne dispose pas de webhook-endpoints:read.
429 rate_limited La limite de débit a été dépassée ; réessayez après la durée indiquée par Retry-After.
503 service_unavailable L'administration des webhooks est temporairement indisponible ; réessayez après la durée indiquée par Retry-After.

Exemple

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