Housing Market API 整合指南

參考表格、端點說明、錯誤代碼和範例皆由 API 規格產生,在所有語言版本中均保留英文。名稱、參數和代碼在各處完全相同。

速率限制與配額

每把金鑰都有每分鐘速率限制,以及每日與每月配額。

您金鑰的限制會顯示在主控台中,且每個回應都帶有 RateLimit-Limit、RateLimit-Remaining 和 RateLimit-Reset 標頭。本指南不公布任何具體數字。

  • rate_limited:您在目前這一分鐘內傳送了過多請求。
  • quota_exceeded:此金鑰的每日或每月配額已用完。

兩者都會以 HTTP 429 傳回,並附帶 Retry-After 標頭,其中包含需等待的秒數。請等待該段時間,再以指數退避方式重試。請勿在緊密迴圈中重試。

使用情況會受到監控。看似在複製資料集或共用金鑰的使用模式,可能導致金鑰遭暫停。