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

# GET /v1/apikeys：列出 PIN API 密钥

> 列出当前 PIN 用户拥有的全部 API 密钥。返回每个密钥的元数据；创建后不会暴露完整密钥值。

使用列出 API 密钥接口获取与当前认证账户关联的全部 API 密钥。响应包含每个密钥的 id、name、prefix 与创建时间戳。不会返回完整密钥值。

## 接口

```http theme={null}
GET /v1/apikeys
```

## 认证

需要有效的 `Authorization: Bearer <jwt-or-api-key>` 头。

## 响应

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

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

    <ResponseField name="prefix" type="string">
      密钥的可见前缀，用于识别。
    </ResponseField>

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

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://ariapin.example.com:8001/v1/apikeys \
    -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "code": 0,
    "data": {
      "items": [
        {
          "id": "key_abc",
          "name": "production",
          "prefix": "prod_...",
          "created_at": "2024-01-15T09:30:00Z"
        }
      ]
    },
    "message": ""
  }
  ```
</ResponseExample>

获取当前用户创建的 API 密钥。每个条目包含 `key_preview`，便于你在无需暴露完整密钥的情况下区分各个密钥。只有创建时返回的明文密钥可用于认证。

## 接口

**GET** `/v1/apikeys`

认证：Bearer API 密钥

## 响应

<ResponseField name="items" type="array">
  限定为当前用户的 API 密钥对象列表。

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

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

    <ResponseField name="key_preview" type="string">
      密钥的掩码预览（例如 `ak_****xyz1`）。
    </ResponseField>

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

## 示例

```bash theme={null}
curl -H "Authorization: Bearer $ARIA_PIN_KEY" \
  http://localhost:8001/v1/apikeys
```

```json theme={null}
{
  "items": [
    {
      "id": "key_7aBc3DeFgH4",
      "name": "default",
      "key_preview": "ak_****wxyz",
      "created_at": "2025-01-15T09:22:00Z"
    }
  ]
}
```