> ## Agent Instructions
>
> Base URL: https://api.anysite.io
> Authentication: send the `access-token` header. Do NOT use `Authorization: Bearer`.
> Full endpoint catalog: https://app.anysite.io/docs
# 身份验证

了解如何使用 Anysite API 进行身份验证

## 概述

Anysite 使用 API 密钥身份验证来保护对所有端点的访问。您需要在所有 API 调用的请求头中包含您的 API 密钥。

## 获取您的 API 密钥

  
#### 创建账户

    访问 [anysite.io](https://app.anysite.io/register) 并创建您的账户
  
  
#### 生成 API 密钥

    导航到您的账户设置并生成新的 API 密钥
  
  
#### 安全存储

    安全存储您的 API 密钥，切勿在客户端代码中暴露
  

## 身份验证方法

### Access Token 头部（必需）

在 `access-token` 头部中包含您的 API 密钥：

```bash
curl -X GET "https://api.anysite.io/token/statistic" \
  -H "access-token: YOUR_API_KEY"
```

> 
Anysite API **不使用** Bearer 令牌身份验证。请始终使用 `access-token` 头部。

## 速率限制

API 请求受速率限制以确保公平使用：

> 
速率限制因端点和订阅计划而异。请查看您的仪表板了解当前限制。

## 错误响应

当身份验证失败时，您将收到以下响应之一：

  无效或缺失的 API 密钥

  API 密钥没有访问此资源的权限

  超出速率限制

## 最佳实践

> 
- 将 API 密钥存储为环境变量
- 为不同的环境使用不同的 API 密钥
- 定期轮换 API 密钥
- 在仪表板中监控 API 使用情况
- 切勿将 API 密钥提交到版本控制

## 测试身份验证

使用此简单请求测试您的身份验证设置：

```bash cURL
curl -X GET "https://api.anysite.io/token/statistic" \
  -H "access-token: YOUR_API_KEY"
```

```python Python
import requests

headers = {
    'access-token': 'YOUR_API_KEY'
}

response = requests.get(
    'https://api.anysite.io/token/statistic',
    headers=headers
)

print(response.json())
```

```javascript JavaScript
const response = await fetch('https://api.anysite.io/token/statistic', {
  headers: {
    'access-token': 'YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);
```