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

# Router 健康与概览接口

> 获取咏唱引擎 ROUTER 的实时健康快照，包括请求量、活跃入口点、运行时长与 provider 健康状态。

Router 概览接口返回咏唱引擎 ROUTER 的精简健康快照。你可以用它监控实时请求计数、活跃入口点、系统运行时长，以及已配置 provider 的整体健康状态。

此接口为只读，不需要管理员角色。可使用有效的会话 Cookie 或 `Authorization: Bearer` API 密钥访问。

## 接口

```http theme={null}
GET /v1/router/overview
```

## 认证

使用会话 Cookie 认证，或携带 `Authorization: Bearer <api-key>`。

## 响应

<ResponseField name="request_count" type="integer">
  router 自启动以来处理的请求总数。
</ResponseField>

<ResponseField name="active_entrypoints" type="integer">
  当前已启用并接受流量的入口点数量。
</ResponseField>

<ResponseField name="uptime_seconds" type="integer">
  router 启动以来经过的时间，以秒为单位。
</ResponseField>

<ResponseField name="providers" type="object">
  provider 名称到其健康状态的映射。

  <Expandable title="属性">
    <ResponseField name="<provider_name>" type="string">
      指定 provider 的健康状态。常见取值：`healthy`、`degraded`、`unavailable`。
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "request_count": 48291,
    "active_entrypoints": 4,
    "uptime_seconds": 172800,
    "providers": {
      "openai": "healthy",
      "anthropic": "healthy",
      "ollama": "degraded"
    }
  }
  ```
</ResponseExample>

## 基础 URL

所有 ROUTER API 请求均使用 `https://router.example.com` 作为主机。