故障排除

原因

• JSON 格式無效
• 缺少必填欄位
• 端點 URL 不匹配

解決方案

• 驗證 JSON 格式
• 在 API 文件中檢查必填欄位
• 驗證端點 URL

原因

• 缺少或為空的 Authorization 請求頭
• API 金鑰格式無效（應為 tm_test_xxx... 或 tm_live_xxx...）
• 此端點的 API 金鑰不正確
• API 金鑰已被端點所有者停用

解決方案

• 包含 Authorization 請求頭（例如 Bearer tm_test_xxx...）
• 沙箱使用 tm_test_xxx...，正式使用 tm_live_xxx...
• 必要時重新生成金鑰
• 聯繫端點所有者重新啟用您的 API 金鑰

原因

• 端點已停用
• 訂閱已過期或月度配額已用完
• 正式環境未部署（使用了 tm_live_ 金鑰）

解決方案

• 驗證端點是否已啟用
• 檢查訂閱狀態
• 如使用 tm_live_ 金鑰，請先部署到正式環境

原因

• 請求主體超過 100KB 大小限制
• JSON 負載中包含大型嵌套陣列或字串

解決方案

• 透過刪除或精簡大型欄位來減少負載大小
• 如果資料確實很大，請拆分為多個較小的請求
• 如果 100KB 不足以滿足您的使用情境，請聯繫 support@3minapi.com

原因

• 缺少或錯誤的 Content-Type 請求頭
• Content-Type 必須為 application/json

解決方案

• 新增請求頭：Content-Type: application/json

原因

• 月度請求額度已用完

解決方案

• 升級方案或等待月度重置
• 在儀表板中監控用量

包括 500（內部伺服器錯誤）、502（閘道錯誤）、503（服務不可用）等。

原因

• 臨時伺服器問題
• 上遊服務（資料庫）暫時不可用
• 服務暫時過載或正在維護

解決方案

• 實現指數退避重試（例如 1秒 → 2秒 → 4秒，最多3次）
• 如錯誤持續，檢查服務狀態
• 如問題持續，聯繫支援：contact@3minapi.com
• 注意：5xx 表示請求未被接收。一旦收到 202 Accepted，資料處理由系統保證。

• 驗證 Webhook URL 是否正確
• 使用 HTTP 或 HTTPS URL
• 端點必須可公開訪問
• 在日誌中檢查 Webhook 狀態

• 返回 2xx 狀態碼表示成功
• 在7秒內回應
• 系統自動重試最多3次
• Webhook 重試可能延遲資料處理