開啟使用量表格
前往後台 → 客製化功能 → API → 使用量。API 頁首會在每個 API 分頁持續顯示過去一小時的摘要;使用量表格則提供逐筆請求紀錄。
斜線前的數字是過去一小時內,系統已辨識 Token 並記錄的 API 請求總數;斜線後的數字是畫面顯示的每小時上限。API 會針對每組 Token 分別執行固定一小時的限制,因此若串接程式需要得知特定 Token 的準確剩餘次數與重設時間,請以回應中的 X-RateLimit-Remaining 與 X-RateLimit-Reset 標頭為準。
篩選請求紀錄
表格預設顯示過去 24 小時。開啟篩選條件後可選擇:
- 過去一小時:查看最新活動。
- 過去 24 小時:進行一般每日檢查。
- 過去 7 天:調查偶發問題。
- API Token:只查看由指定 Token 發出的請求;清除選擇即可再次顯示所有 Token。
點選重新整理按鈕可取得最新活動。若篩選後的結果超過目前頁面,請使用表格下方的標準載入更多功能。
查看每筆請求
每筆資料列包含:
- Token——該次請求所使用的 Token 標籤。
- 方法——HTTP 操作,例如 GET、POST、PATCH 或 DELETE。
- 端點——實際呼叫的 API 路徑。系統刻意不儲存查詢字串。
- 回應——HTTP 結果。2xx 代表成功完成;4xx 代表請求、身分驗證、權限或頻率限制問題;5xx 代表伺服器端失敗。
- 時間——系統記錄該次請求的時間。
無回應代表請求已開始,但未正常完成,例如發生嚴重錯誤、逾時或處理程序遭終止。
調查非預期使用量
先選擇過去一小時,再選取您要檢查的 Token。將請求時間、方法與端點路徑,和串接程式本身的紀錄或排程工作比對。若同一端點反覆出現,可能表示輪詢頻率過高;若短時間內集中出現多筆 4xx 或 5xx,則可能是失敗請求正在不斷重試。
在系統辨識 Token 前就被拒絕的請求不會顯示,包括未提供 Token、Token 格式錯誤,或使用已刪除 Token 的請求,因為系統無法將其歸屬至有效 Token。若預期中的活動沒有出現,除了本表格之外,也請檢查串接程式的回應與身分驗證紀錄。
