> ## 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.