# 限制與配額

下列為平台層級的固定限制；與方案相關的額度（RPS、Burst、credit 配額）則依你的方案而定。

## 分頁

| 項目         | 值                        |
| ---------- | ------------------------ |
| `limit` 預設 | 20                       |
| `limit` 上限 | 1000                     |
| 超過上限       | 回 `400 bad_request`（不截斷） |

## 限流（依方案）

| 項目    | 說明                          |
| ----- | --------------------------- |
| 維度    | 每 API key + 端點              |
| RPS   | 每秒請求數，依方案                   |
| Burst | 突發容量，依方案                    |
| 超量行為  | `reject`（回 429）或 `wait`（排隊） |

詳見[限流](/documentation/he-xin-gai-nian/rate-limiting.md)。

## Credit

| 項目   | 說明                          |
| ---- | --------------------------- |
| 計費時機 | 僅成功（2xx）回應                  |
| 餘額不足 | 回 `402 insufficient_credit` |
| 每月配額 | 依方案 `monthly_credit_quota`  |

## 輸入欄位限制

| 欄位                   | 限制                                     |
| -------------------- | -------------------------------------- |
| Webhook `target_url` | 須以 `http://` 或 `https://` 開頭，長度 ≤ 2048 |
| Webhook `event_type` | 1–64 字元                                |
| `X-Request-Id`（自帶）   | ≤ 128 字元，僅限英數、`-`、`_`                  |

## 請求

| 項目     | 說明                        |
| ------ | ------------------------- |
| 請求逾時   | 逾時回 `408 Request Timeout` |
| 請求主體大小 | 超過上限會被拒絕                  |

{% hint style="info" %}
逾時與主體大小上限可依部署環境設定，正式環境的實際值請洽你的客戶經理。
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.blockchainsecurity.asia/documentation/api-can-kao/limits.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.