開發者文件
錯誤碼
錯誤回應皆為 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 格式不正確。
403Forbidden金鑰有效，但方案 tier 不足。例如以 Free key 查詢 Lite 資料集。
404Not Found資料集名稱不存在，或請求路徑不正確。
429Too Many Requests已超過每小時速率上限。retry_after_seconds 會標示建議等待秒數。
503Service Unavailable服務暫時不可用，通常與資料庫連線或維護有關。請稍後重試。
ℹ
5xx 錯誤持續出現時，請先確認 status.clarifindata.com 的即時狀態，或寄信至 [email protected]。