# 웹훅 엔드포인트 조회

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

웹훅 엔드포인트 하나를 반환합니다. `ETag` 헤더는 엔드포인트의 버전이며, [수정](update.md) 및 [삭제](delete.md)에서 사용하는 `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`으로 응답한 경우). [수정](update.md)에서 `"status": "enabled"`를 설정하여 다시 활성화할 수 있으며, 비활성화된 기간의 이벤트는 재전송으로 처리하십시오. |
| `rate_limit_per_second` | 이 엔드포인트의 전달 속도 상한. |
| `previous_secret_expires_at` | 교체 후, 이전 비밀 값이 전달에 계속 서명하는 기간의 종료 시점. 그 외에는 `null`. |
| `last_success_at` | 마지막으로 성공한 전달 시점, 또는 `null`. |
| `failing_since` | 연속으로 실패한 전달의 시작 시점, 또는 `null`. |
| `version` | 버전. `ETag` 헤더와 같습니다. |
| `created_at`, `updated_at` | 타임스탬프. |

```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"
}
```

## 오류

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

## 예제

```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`