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

# 客户 API

> 以编程方式管理许可证、API 密钥、配置文件和发票

客户 API 允许已认证用户以编程方式管理其 OrbitFlare 资源。它支持两个版本：**v1**（仅 API 密钥认证）和 **v2**（Bearer 令牌或 API 密钥，具有扩展功能，包括认证流程、配置文件管理和发票操作）。

## 认证

OrbitFlare 根据您使用的 API 版本支持两种认证方法。

**API 密钥（v1 和 v2）：** 通过 `X-ORBIT-KEY` 请求头传递您的 API 密钥。此方法适用于 v1 和 v2 端点。

**Bearer 令牌（仅 v2）：** 通过设备授权流程或钱包签名认证获取。在标准 `Authorization: Bearer <token>` 头中传递令牌。

<Tip>
  API 密钥在两个版本中均可使用。如果您只需要基本的许可证管理，API 密钥是最简单的认证方式。
</Tip>

```bash theme={null}
curl -X GET https://api.orbitflare.com/v2/licenses \
  -H "X-ORBIT-KEY: your-api-key-here"
```

## API v2 端点

<CardGroup cols={3}>
  <Card title="认证" icon="key" href="/api-documentation/v2/auth/device-code">
    设备流程、钱包认证、会话管理
  </Card>

  <Card title="许可证" icon="id-card" href="/api-documentation/v2/licenses/list">
    列出、管理和配置许可证
  </Card>

  <Card title="API 密钥" icon="lock" href="/api-documentation/v2/api-keys/list">
    创建、更新和管理 API 密钥
  </Card>

  <Card title="配置文件" icon="user" href="/api-documentation/v2/profile/get">
    查看和更新用户配置文件
  </Card>

  <Card title="发票" icon="file-invoice" href="/api-documentation/v2/invoices/list">
    查看发票并使用余额支付
  </Card>
</CardGroup>

## 旧版 API v1

<Warning>
  API v1 已弃用，将在未来版本中移除。请迁移到 v2 以访问完整的端点集和改进的认证选项。
</Warning>

<CardGroup cols={2}>
  <Card title="v1 客户端点" icon="clock-rotate-left" href="/api-documentation/customer-endpoints/get-licenses">
    旧版许可证管理端点
  </Card>

  <Card title="迁移指南" icon="arrow-right" href="/cn/api-documentation/migration">
    从 v1 升级到 v2 的分步指南
  </Card>
</CardGroup>