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

# Fundamentals

在发起第一次 API 调用之前，您需要：有效的 API Token、每次请求正确的 HTTP 请求头，以及已在后台登记的服务器 IP 地址。本页说明这些前提条件，并介绍系统安全限制、代理/运营商层级结构，以及余额体系的工作方式。

## 开始前需要准备什么

使用我们的 API，需要由管理员发放的 `API_TOKEN`。该 Token 是您每次 API 请求的身份凭证——请像对待密码一样妥善保管，切勿在客户端代码或公开仓库中暴露。

`API_TOKEN` 示例如下:

```text theme={null}
60349266c8d9487eab7531b1a15d2480
```

账号开通后，可在后台的「设置」中查看您的 Token。

<Note>
  每个账号仅对应一种货币。若需支持多种货币，请为每种货币分别开设账号。
</Note>

如需开通账号，请联系我们。

## HTTP headers

每次 API 请求都必须包含以下三个 HTTP 请求头。您可在后台管理员账号的设置页中核对 `API_TOKEN` 的值。

| Name            | Value                | Example                                                  |
| :-------------- | :------------------- | :------------------------------------------------------- |
| `Authorization` | `Bearer {API_TOKEN}` | `Authorization: Bearer 60349266c8d9487eab7531b1a15d2480` |
| `Accept`        | `application/json`   | `Accept: application/json`                               |
| `Content-Type`  | `application/json`   | `Content-Type: application/json`                         |

使用这些请求头的请求示例如下：

```bash theme={null}
curl --request GET \
  --url https://api.igamingace.com/v1/provider/list \
  --header "Authorization: Bearer 60349266c8d9487eab7531b1a15d2480" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json"
```

## 系统安全

同一代理的并发请求上限为 50。超出该限制时，API 将返回错误码 `SERVER_IS_BUSY（1018）`。

<Warning>
  收到 `SERVER_IS_BUSY (1018)` 时，请勿立即重试。应等待已发出的请求完成后再发送新请求。
</Warning>

## IP 限制

API 仅接受来自您在后台 **\[设置]** 页面登记的服务器 IP 地址的请求。请将每个允许的 IP 地址按换行分隔填写，例如：

```text theme={null}
1.1.1.1
2.2.2.2
```

<Note>
  若 **\[Allowed IP]** 字段留空，则 API 接受来自任意 IP 的请求。生产环境强烈建议启用 IP 限制。
</Note>

## 代理与运营商层级

API 采用层级模型管理运营商：

* **Agent** : 单个赌场网站运营商。每个代理拥有独立的后台账号，并管理自有玩家。
* **Operator** : 在层级中管理多个代理。作为运营商，您可按需创建任意数量的子代理，并监管下属的所有代理。