Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
帳獸 API 頻率限制規則、回應標頭與超限處理
| 類型 | 額度 | 計算依據 |
|---|---|---|
| 已認證請求 | 3,600 次/小時 | 依商家 ID 計算 |
| 未認證請求 | 10 次/分鐘 | 依 IP 位址計算 |
| 標頭 | 說明 | 範例 |
|---|---|---|
X-RateLimit-Limit | 限制額度 | 3600 |
X-RateLimit-Remaining | 剩餘可用次數 | 3597 |
X-RateLimit-Reset | 限制重置時間（Unix timestamp） | 1738915200 |
HTTP/1.1 200 OK
Content-Type: application/json
X-RateLimit-Limit: 3600
X-RateLimit-Remaining: 3597
X-RateLimit-Reset: 1738915200
429 Too Many Requests：
{
"message": "Too Many Requests"
}
Retry-After 標頭，告知你應等待的秒數：
HTTP/1.1 429 Too Many Requests
Retry-After: 60
Content-Type: application/json
async function requestWithRetry(url, options, maxRetries = 3) {
for (let attempt = 0; attempt < maxRetries; attempt++) {
const response = await fetch(url, options);
if (response.status === 429) {
const retryAfter = parseInt(response.headers.get('Retry-After') || '60');
console.log(`頻率限制，等待 ${retryAfter} 秒後重試...`);
await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
continue;
}
return response;
}
throw new Error('超過最大重試次數');
}
function requestWithRetry(string $url, array $data = [], int $maxRetries = 3)
{
for ($attempt = 0; $attempt < $maxRetries; $attempt++) {
$response = Http::withToken(config('services.zangsho.token'))
->get($url, $data);
if ($response->status() === 429) {
$retryAfter = (int) $response->header('Retry-After', 60);
Log::info("頻率限制，等待 {$retryAfter} 秒後重試...");
sleep($retryAfter);
continue;
}
return $response;
}
throw new \RuntimeException('超過最大重試次數');
}
X-RateLimit-Remaining，在接近 0 時主動降速/customers/batch）一次處理多筆資料，減少請求次數