> ## 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 API 密钥接口

> 列出咏唱引擎 ROUTER 中注册的全部 API 密钥。返回元数据、作用域与前缀信息，不暴露完整密钥值。

列出密钥接口返回咏唱引擎 ROUTER 中已配置 API 密钥的翻页集合。每个条目包含标识符、显示名称、可见的密钥前缀、授予的作用域与创建时间戳。创建后永远不会再返回完整密钥值。

任何已认证调用者均可访问此接口。

## 接口

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

## 认证

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

## 响应

<ResponseField name="items" type="array">
  API 密钥列表。

  <Expandable title="items">
    <ResponseField name="id" type="string">
      唯一的密钥标识符。
    </ResponseField>

    <ResponseField name="name" type="string">
      便于识别的密钥名称。
    </ResponseField>

    <ResponseField name="prefix" type="string">
      密钥的可见前缀。
    </ResponseField>

    <ResponseField name="scopes" type="array">
      授予的权限作用域。

      <Expandable title="strings" />
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 创建时间戳。
    </ResponseField>
  </Expandable>
</ResponseField>

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "items": [
      {
        "id": "key_01hv8",
        "name": "Production pipeline",
        "prefix": "aria_9f3a",
        "scopes": ["read", "write"],
        "created_at": "2024-06-01T12:00:00Z"
      },
      {
        "id": "key_01hv9",
        "name": "Staging agent",
        "prefix": "aria_2b7c",
        "scopes": ["read"],
        "created_at": "2024-06-10T08:30:00Z"
      }
    ]
  }
  ```
</ResponseExample>