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

# 健康檢查

> 檢查系統健康狀況 — 無需身份驗證。

公開端點，返回 Theo 基礎設施及 AI 引擎子系統的當前健康狀態。**無需身份驗證。**

<Note>
  健康檢查結果會緩存 30 秒。`X-Cache` 響應頭會標明 `HIT` 或 `MISS`。
</Note>

## 請求示例

```bash theme={null}
curl https://www.hitheo.ai/api/v1/health
```

## 響應

<ResponseField name="status" type="string">
  系統整體狀態：`"healthy"`（健康）、`"degraded"`（降級）或 `"down"`（不可用）。
</ResponseField>

<ResponseField name="timestamp" type="string">
  本次健康檢查的 ISO 8601 時間戳。
</ResponseField>

<ResponseField name="version" type="string">
  API 版本標識符（例如 `"2026-03-28"`）。
</ResponseField>

<ResponseField name="providers" type="object">
  AI 引擎子系統的健康狀況。

  <Expandable title="Provider health object">
    每個鍵為一個 Theo 子系統名稱（例如 `theo-core`、`theo-vision`、`theo-search`）。對應的值包含：
    <ResponseField name="status" type="string">`"healthy"`（健康）、`"degraded"`（降級）、`"down"`（不可用）或 `"unconfigured"`（未配置）。</ResponseField>
  </Expandable>
</ResponseField>

### 響應示例

```json theme={null}
{
  "status": "healthy",
  "timestamp": "2026-04-10T12:00:00.000Z",
  "version": "2026-03-28",
  "providers": {
    "theo-core": { "status": "healthy" },
    "theo-vision": { "status": "healthy" },
    "theo-search": { "status": "healthy" }
  }
}
```

## 狀態碼

| 狀態碼 | 含義 |
| - | - |
| 200 | 系統健康或處於降級狀態 |
| 503 | 系統不可用 — 響應中包含 `Retry-After: 30` 頭 |


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