開發者文件
錯誤碼
所有錯誤回應都是 JSON 格式，包含 detail 欄位說明原因。
json
{
"detail": "rate limit exceeded (605/600 per hour for free tier)",
"retry_after_seconds": 42
}400Bad Request請求格式錯誤，例如日期格式不對、參數型別錯誤。body 的 detail 欄位有說明。
401Unauthorized缺少 Authorization header，或 Bearer token 格式不正確。
403ForbiddenAPI Key 存在但 tier 不足。例如用 Free key 查 Lite 資料集。
404Not Found資料集名稱不存在，或路由不正確。
429Too Many Requests超過每小時速率上限。body 帶 retry_after_seconds。
500Internal Server Error伺服器端錯誤。可到 /status 確認服務狀態，或聯絡客服。
503Service Unavailable服務暫時不可用（資料庫連線等）。稍後重試即可。
ℹ
如遇到 5xx 持續出現，請到 /status 查看即時服務狀態，或寄信到 support@clarifindata.com。