> ## 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)。

状态码分类如下：

<ul class="custom-bullets">
  <li>1xx：信息性 - 传递传输协议层面的信息。</li>
  <li>2xx：成功 - 请求成功完成。</li>
  <li>3xx：重定向 - 客户端必须进行额外操作才能完成请求。</li>
  <li>4xx：客户端错误 - 因客户端错误导致请求失败。</li>
  <li>5xx：服务器错误 - 因服务器错误导致请求失败。</li>
</ul>

### 200 成功

请求成功执行。

### 400 Bad Request

`400 Bad Request` 错误意味着服务器无法继续处理请求。最常见的原因是请求 URL 或请求体的语法错误。

### 401 Unauthorized

`401 Unauthorized` 错误通常由 API 调用请求头中的问题引起，例如你没有使用有效的 API Key 发起 API 调用。

### 403 Access Denied

当你的应用使用你的 API Key 发起 API 调用而该请求不被允许时会返回此错误。
如果 [User Profile 被暂停](/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

#### User Profile 速率限制

每个 User Profile 的速率限制为每 5 分钟 300 次 API 请求。你可以通过响应头监控当前的速率限制使用情况：

<ul class="custom-bullets">
  <li>`x-ratelimit-max`：显示每 5 分钟允许的最大请求数</li>

  <li>
    `x-ratelimit-count`：显示你在当前 5 分钟周期内已发起的请求数
  </li>
</ul>

<Info>
  我们建议对 429 错误码的响应进行检查。看到 429 错误时，说明你已达到
  速率限制。反复尝试超出速率限制可能导致该 User Profile 被暂停。

  了解更多关于[多个 User Profile 的速率限制处理](https://www.ayrshare.com/blog/complete-guide-to-handling-rate-limits-prevent-429-errors/)。
</Info>

#### 平台分析数据速率限制

当社交网络对某个特定账号的分析数据调用进行限流时（与你的 Ayrshare User Profile 限制无关），也可能返回 HTTP `429`。这种情况下，响应会带有一个平台相关的 Ayrshare 错误码（例如 Facebook Page 级分析限流时的 [`code: 444`](/errors/errors-ayrshare#facebook-analytics-rate-limit)）。请检查 `code` 字段以区分是资料级速率限制还是平台侧的限流，并使用退避策略重试，而不是让用户重新关联。

#### User Profile 删除速率限制

每秒最多可删除 8 个 User Profile。如果你需要批量删除，请分批调用 API。

#### 速率限制保护与暂停策略

为保护系统的完整性，若某个 User Profile 过于频繁地超出速率限制，我们会自动将其暂停。
具体机制如下：

发起 API 请求时，你必须细致地管理这个 5 分钟窗口。
例如，如果你在 1 分钟内发起了 300 个请求，那么在再次发起请求之前，还需要等待 4 分钟。
在等待期内的任何请求都会触发 `429` 错误响应。

如果一个 User Profile 在 24 小时内累计触发 1,000 次速率限制违规（429 错误），该资料将被自动暂停。
等待 5 分钟结束后，你可以按照每 5 分钟 300 次的标准限额继续发起请求。

### 500 Internal Server Error

`500 Internal Server Error` 表示 Ayrshare 遇到了内部错误或处理失败。