> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API 参考

> 用于通过服务密钥认证查询 Windsurf 使用数据并管理配置的 Enterprise API

<div id="overview">
  ## 概述
</div>

Windsurf API 使 Enterprise 客户能够以编程方式访问详尽的使用 Analytics，并为其 Teams 管理使用配置。

<Note>该 API 仅适用于 Enterprise 计划</Note>

<div id="base-url">
  ## 基础 URL
</div>

所有 API 请求应发送至：

```
https://server.codeium.com/api/v1/
```

<div id="authentication">
  ## 身份验证
</div>

Windsurf API 使用服务密钥进行身份验证。所有 API 调用的请求体中都必须包含服务密钥。

<div id="creating-a-service-key">
  ### 创建服务密钥
</div>

1. 前往你的[团队设置页面](https://windsurf.com/team/settings)
2. 进入“服务密钥”部分
3. 按需设置权限，创建新的服务密钥
4. 复制生成的服务密钥用于 API 请求

<div id="required-permissions">
  ### 所需权限
</div>

不同的 API 端点需要不同的权限。请参考各个端点的文档以了解所需的具体权限：

| 端点                                                                                                              | 所需权限            |
| --------------------------------------------------------------------------------------------------------------- | --------------- |
| [Custom Analytics](/zh/plugins/accounts/api-reference/custom-analytics) (`/Analytics`)                          | Analytics Read  |
| [User Page Analytics](/zh/plugins/accounts/api-reference/user-page-analytics) (`/UserPageAnalytics`)            | Teams Read-Only |
| [Cascade Analytics](/zh/plugins/accounts/api-reference/cascade-analytics) (`/CascadeAnalytics`)                 | Teams Read-Only |
| [Set Usage Configuration](/zh/plugins/accounts/api-reference/usage-config) (`/UsageConfig`)                     | Billing Write   |
| [Get Usage Configuration](/zh/plugins/accounts/api-reference/get-usage-config) (`/GetUsageConfig`)              | Billing Read    |
| [Get Team Credit Balance](/zh/plugins/accounts/api-reference/get-team-credit-balance) (`/GetTeamCreditBalance`) | Billing Read    |

<div id="using-service-keys">
  ### 使用服务密钥
</div>

在所有 API 调用中，将你的服务密钥包含在请求正文中：

```json theme={null}
{
  "service_key": "your_service_key_here",
  // ... 其他参数
}
```

<Warning>请妥善保管你的服务密钥，切勿在客户端代码或公共代码库中暴露</Warning>

<div id="rate-limits">
  ## 速率限制
</div>

为了确保服务稳定性，API 请求会受到速率限制。如果你超过限制，将收到状态码为 `429 Too Many Requests` 的响应。

<div id="support">
  ## 支持
</div>

如需 API 支持或有任何问题，请联系 [Windsurf 支持](https://windsurf.com/support)。