> ## 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 上的用户

> GET /v1/router/users 返回翻页的用户账户列表。此仅限管理员的接口用于咏唱引擎 ROUTER 的用户管理。

获取在咏唱引擎 ROUTER 上注册的全部用户账户列表。此接口仅限于管理员用户，返回包含身份与状态字段的用户对象集合。

## 接口

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

## 认证

需要管理员角色。发送从登录获取的会话 Cookie，或携带 `Authorization: Bearer <api-key>`。

## 响应

<ResponseField name="items" type="array">
  用户对象数组。
</ResponseField>

<ResponseField name="items[].id" type="string">
  用户的唯一标识符。
</ResponseField>

<ResponseField name="items[].username" type="string">
  账户的用户名。
</ResponseField>

<ResponseField name="items[].email" type="string | null">
  若已设置则为邮箱，否则为 null。
</ResponseField>

<ResponseField name="items[].role" type="string">
  用户角色，例如 `"user"` 或 `"admin"`。
</ResponseField>

<ResponseField name="items[].disabled" type="boolean">
  账户当前是否被禁用。
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://router.example.com:8080/v1/router/users \
    -H "Authorization: Bearer <admin-api-key>"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "items": [
      {
        "id": "user-abc123",
        "username": "alice",
        "email": "alice@example.com",
        "role": "user",
        "disabled": false
      },
      {
        "id": "user-def456",
        "username": "bob",
        "email": null,
        "role": "admin",
        "disabled": false
      }
    ]
  }
  ```
</ResponseExample>