> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# HTTP 狀態碼
> 回應中回傳的 HTTP 代碼。
錯誤會以[標準 HTTP 狀態碼](https://tools.ietf.org/html/rfc2616#section-10)回傳。
狀態碼如下：
- 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 呼叫，但該請求不被允許時發生。
若 [使用者個人資料被暫停](/multiple-users/manage-user-profiles#reactivate-a-suspended-user-profile)，也可能回傳 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 錯誤，代表你已達到速率
限制。持續嘗試超過速率限制可能會導致使用者個人資料被暫停。
進一步了解如何為多個使用者個人資料[處理速率限制](https://www.ayrshare.com/blog/complete-guide-to-handling-rate-limits-prevent-429-errors/)。
#### 平台分析速率限制
當某個社群網路對特定帳戶的分析呼叫進行節流時，也可能回傳 HTTP `429` — 此與你的 Ayrshare 使用者個人資料限制無關。此時回應會帶有平台特定的 Ayrshare 錯誤代碼（例如 Facebook 各專頁分析節流的 [`code: 444`](/errors/errors-ayrshare#facebook-analytics-rate-limit)）。請檢查 `code` 欄位以區分是個人資料速率限制或平台端節流，並以退避策略重試，而不是提示使用者重新連結。
#### 使用者個人資料刪除速率限制
你每秒最多可刪除 8 個使用者個人資料。若需要大量刪除，請錯開 API 呼叫。
#### 速率限制保護與暫停政策
為保護我們的系統完整性，若使用者個人資料過於頻繁超過速率限制，我們會自動實施暫停。
其運作方式如下：
當你發送 API 請求時，你必須謹慎管理 5 分鐘的時間窗。
例如，若你在一分鐘內發出 300 個請求，你需要再等待四分鐘才能發送更多請求。
在此等待期間的任何請求都會觸發 `429` 錯誤回應。
若使用者個人資料在 24 小時內累積 1,000 次速率限制違規（429 錯誤），該個人資料將被自動暫停。
5 分鐘等待期結束後，你可以恢復發送請求，直到每 5 分鐘 300 次的標準限制。
### 500 Internal Server Error
`500 Internal Server Error` 表示 Ayrshare 發生內部錯誤或處理失敗。