> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitheo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook 統計

> 獲取某個 webhook 的投遞指標：總投遞次數、成功/失敗次數以及成功率。

## 路徑參數

<ParamField path="id" type="string" required>
  該 webhook 的 UUID。
</ParamField>

## 響應

<ResponseField name="webhook_id" type="string">該 webhook 的 UUID</ResponseField>
<ResponseField name="enabled" type="boolean">當前的啓用狀態</ResponseField>
<ResponseField name="consecutive_failures" type="number">當前連續失敗的次數。成功一次後會重置；一旦該連續失敗次數超過服務器端設定的閾值，webhook 會被自動禁用。</ResponseField>
<ResponseField name="last_delivered_at" type="string | null">最近一次成功投遞的時間戳</ResponseField>

<ResponseField name="deliveries" type="object">
  <Expandable title="投遞指標">
    <ResponseField name="total" type="number">投遞嘗試的總次數</ResponseField>
    <ResponseField name="successes" type="number">成功投遞的次數</ResponseField>
    <ResponseField name="failures" type="number">失敗投遞的次數</ResponseField>
    <ResponseField name="success_rate_percent" type="number | null">以百分比表示的成功率（如果沒有任何投遞記錄，則為 null）</ResponseField>
  </Expandable>
</ResponseField>

## 示例

```bash theme={null}
curl https://www.hitheo.ai/api/v1/webhooks/WEBHOOK_ID/stats \
  -H "Authorization: Bearer $THEO_API_KEY"
```

### 響應

```json theme={null}
{
  "webhook_id": "a1b2c3d4-...",
  "enabled": true,
  "consecutive_failures": 0,
  "last_delivered_at": "2026-04-15T12:01:00.000Z",
  "deliveries": {
    "total": 142,
    "successes": 140,
    "failures": 2,
    "success_rate_percent": 98.59
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.