웹훅 엔드포인트 조회

GET /v1/webhook-endpoints/{endpoint_id} · 권한 webhook-endpoints:read · 모든 요금제

웹훅 엔드포인트 하나를 반환합니다. ETag 헤더는 엔드포인트의 버전이며, 수정 및 삭제에서 사용하는 If-Match 값입니다. 서명 비밀 값은 여기서 반환되지 않습니다.

요청

필드 유형 필수 설명
endpoint_id path 예 웹훅 엔드포인트 ID(whe_…).

응답

200 OK와 함께 엔드포인트가 반환됩니다.

필드 설명
id 엔드포인트 ID(whe_…).
key 환경 내에서 고유한 고정 키.
url 수신 URL.
description 자유 형식 텍스트. 없으면 빈 문자열.
event_types 선택된 카탈로그 이벤트 유형. 비어 있으면 대량 발생 유형을 제외한 모든 유형.
event_schema_versions 이벤트 유형 → 스키마 버전 재정의.
payload_mode thin 또는 full.
status enabled, disabled_by_user, disabled_by_failure(5일 동안 성공한 전달이 없고 포기된 전달이 10건 이상인 경우), 또는 disabled_by_receiver(수신 측이 410 Gone으로 응답한 경우). 수정에서 "status": "enabled"를 설정하여 다시 활성화할 수 있으며, 비활성화된 기간의 이벤트는 재전송으로 처리하십시오.
rate_limit_per_second 이 엔드포인트의 전달 속도 상한.
previous_secret_expires_at 교체 후, 이전 비밀 값이 전달에 계속 서명하는 기간의 종료 시점. 그 외에는 null.
last_success_at 마지막으로 성공한 전달 시점, 또는 null.
failing_since 연속으로 실패한 전달의 시작 시점, 또는 null.
version 버전. ETag 헤더와 같습니다.
created_at, updated_at 타임스탬프. 
{
  "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"
}

오류

HTTP code 발생 조건
404 not_found 이 환경에 해당 엔드포인트가 없습니다(다른 환경의 엔드포인트이거나 ID 형식이 잘못된 경우에도 해당).
401 unauthenticated 자격 증명이 없거나 잘못되었거나 취소되었습니다.
403 insufficient_permissions 자격 증명에 webhook-endpoints:read 권한이 없습니다.
429 rate_limited 요청 한도를 초과했습니다. Retry-After 기간 이후에 다시 시도하십시오.
503 service_unavailable 웹훅 관리 기능을 일시적으로 사용할 수 없습니다. Retry-After 기간 이후에 다시 시도하십시오.

예제

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