# 身份验证

> 创建 API 令牌并发起第一个认证请求。

Source: https://docs.avenlith.com/zh/api-authentication  
Category: API 与自动化  
Last updated: 2026-09-20

## 令牌

在 **项目 → API 令牌** 中创建令牌。令牌仅作用于单个项目，可设为只读或读写。

## 请求

以 Bearer 头发送令牌：

```bash
curl https://api.avenlith.com/v1/servers \
  -H "Authorization: Bearer $AVENLITH_TOKEN"
```

## 响应

```json
{
  "data": [
    { "id": "srv_8f2k1", "name": "web-01", "region": "ist1", "status": "running" }
  ],
  "meta": { "page": 1, "total": 1 }
}
```

## 速率限制

每个令牌每小时最多 3,600 次请求，剩余配额通过 `X-RateLimit-Remaining` 头返回。