- 1xx：資訊性 - 傳達傳輸協定層級的資訊。
- 2xx：成功 - 請求已成功。
- 3xx：重新導向 - 用戶端必須執行額外動作才能完成請求。
- 4xx：用戶端錯誤 - 因用戶端錯誤導致請求失敗。
- 5xx：伺服器錯誤 - 因伺服器錯誤導致請求失敗。
200 Success
請求已成功。400 Bad Request
400 Bad Request 錯誤代表伺服器無法繼續處理請求。最常見的原因是請求 URL 或 body 的語法錯誤。
401 Unauthorized
401 Unauthorized 錯誤通常是由 API 呼叫的請求標頭問題所導致，例如你未使用有效的 API 金鑰進行 API 呼叫。
403 Access Denied
當你的應用使用你的 API 金鑰進行 API 呼叫，但該請求不被允許時發生。 若 使用者個人資料被暫停，也可能回傳 403。404 Resource Not Found
當你的應用嘗試呼叫不存在的 API 或擷取不存在的實體時，會發生此錯誤。405 Method Not Allowed
此錯誤表示你請求中的 HTTP 方法不受支援。請查閱 API 文件了解支援的方法。429 Rate Limit
使用者個人資料速率限制
每個使用者個人資料的速率限制為每 5 分鐘 300 次 API 請求。你可以透過回應標頭監控速率限制的使用情況：x-ratelimit-max：顯示你每 5 分鐘週期內允許的最大請求數x-ratelimit-count：顯示你在目前 5 分鐘週期中已發送的請求數
我們建議檢查 429 錯誤代碼回應。若你看到 429 錯誤，代表你已達到速率
限制。持續嘗試超過速率限制可能會導致使用者個人資料被暫停。進一步了解如何為多個使用者個人資料處理速率限制。
平台分析速率限制
當某個社群網路對特定帳戶的分析呼叫進行節流時，也可能回傳 HTTP429 — 此與你的 Ayrshare 使用者個人資料限制無關。此時回應會帶有平台特定的 Ayrshare 錯誤代碼（例如 Facebook 各專頁分析節流的 code: 444）。請檢查 code 欄位以區分是個人資料速率限制或平台端節流，並以退避策略重試，而不是提示使用者重新連結。
使用者個人資料刪除速率限制
你每秒最多可刪除 8 個使用者個人資料。若需要大量刪除，請錯開 API 呼叫。速率限制保護與暫停政策
為保護我們的系統完整性，若使用者個人資料過於頻繁超過速率限制，我們會自動實施暫停。 其運作方式如下： 當你發送 API 請求時，你必須謹慎管理 5 分鐘的時間窗。 例如，若你在一分鐘內發出 300 個請求，你需要再等待四分鐘才能發送更多請求。 在此等待期間的任何請求都會觸發429 錯誤回應。
若使用者個人資料在 24 小時內累積 1,000 次速率限制違規（429 錯誤），該個人資料將被自動暫停。
5 分鐘等待期結束後，你可以恢復發送請求，直到每 5 分鐘 300 次的標準限制。
500 Internal Server Error
500 Internal Server Error 表示 Ayrshare 發生內部錯誤或處理失敗。