> ## 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/auth/me：PIN 当前用户

> 获取当前 PIN 用户的资料，包括 id、用户名、邮箱与角色。需要有效的 Bearer API 密钥。

获取与所提供 Bearer API 密钥关联的用户资料。可用于校验密钥有效性以及查看用户权限。

## 接口

**GET** `/v1/auth/me`

认证：Bearer API 密钥

## 响应

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

<ResponseField name="username" type="string">
  注册的用户名。
</ResponseField>

<ResponseField name="email" type="string">
  用户的邮箱地址。
</ResponseField>

<ResponseField name="role" type="string">
  用户角色。取值之一：`admin`、`user`。
</ResponseField>

## 示例

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

```json theme={null}
{
  "id": "usr_2vPqN9xL5wR8",
  "username": "alice",
  "email": "alice@example.com",
  "role": "admin"
}
```