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

## 行为说明

派发一个 `completion.created` 事件,其数据负载中包含 `_test: true`。此次投递会使用与真实事件相同的 HMAC 签名、SSRF 检测和重试逻辑。

## 示例

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://www.hitheo.ai/api/v1/webhooks/WEBHOOK_ID/test \
    -H "Authorization: Bearer $THEO_API_KEY"
  ```

  ```typescript SDK theme={null}
  await theo.testWebhook("WEBHOOK_ID");
  ```
</CodeGroup>

### 响应

```json theme={null}
{ "sent": true }
```

### 你的服务器收到的测试事件负载

```json theme={null}
{
  "id": "evt_abc123...",
  "type": "completion.created",
  "created": "2026-04-15T12:00:00.000Z",
  "data": {
    "_test": true,
    "message": "This is a test event from Theo. If you received it, your webhook is working!"
  }
}
```

<Tip>
  可通过[投递日志](/api-reference/webhooks/deliveries)查看该测试事件是否投递成功。
</Tip>


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