# 授权与限制

在[集成 (Integrations)](https://dash.bitsby.app/integrations/list) 中获取 API 密钥。

## 功能

* **收款单管理**：创建、取消、查询状态
* **付款管理**：付款列表、将付款关联到收款单
* **统计**：按项目、时间段、钱包等汇总的数据
* **计费**：项目费率、余额

## 限制

* **请求频率**：每把密钥每秒最多 1 个请求
* **密钥数量**：每个账户 10 把

## 请求授权

每个 API 请求都要在 `Authorization` 头中传递 API 密钥来授权。

API 请求中 `Authorization` 头的示例：

```bash
curl -X POST https://api.bitsby.app/invoices/list \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay"
```

## 服务器响应

API 服务器始终以 JSON 响应。用 `result` 参数判断请求是否成功。

成功请求的响应示例：

```json
{
    "result": "success",
    "data": .....
}
```

出错时的响应示例：

```json
{
    "result": "error",
    "data": "Requests too frequent"
}
```
