- 1xx：信息性 - 传递传输协议层面的信息。
- 2xx：成功 - 请求成功完成。
- 3xx：重定向 - 客户端必须进行额外操作才能完成请求。
- 4xx：客户端错误 - 因客户端错误导致请求失败。
- 5xx：服务器错误 - 因服务器错误导致请求失败。
200 成功
请求成功执行。400 Bad Request
400 Bad Request 错误意味着服务器无法继续处理请求。最常见的原因是请求 URL 或请求体的语法错误。
401 Unauthorized
401 Unauthorized 错误通常由 API 调用请求头中的问题引起，例如你没有使用有效的 API Key 发起 API 调用。
403 Access Denied
当你的应用使用你的 API Key 发起 API 调用而该请求不被允许时会返回此错误。 如果 User Profile 被暂停，也可能返回 403。404 Resource Not Found
当你的应用尝试调用不存在的 API 或获取不存在的实体时会出现此错误。405 Method Not Allowed
此错误表示请求中的 HTTP 协议方法不被支持。请查阅 API 文档以了解支持的方法。429 Rate Limit
User Profile 速率限制
每个 User Profile 的速率限制为每 5 分钟 300 次 API 请求。你可以通过响应头监控当前的速率限制使用情况：x-ratelimit-max：显示每 5 分钟允许的最大请求数x-ratelimit-count：显示你在当前 5 分钟周期内已发起的请求数
我们建议对 429 错误码的响应进行检查。看到 429 错误时，说明你已达到
速率限制。反复尝试超出速率限制可能导致该 User Profile 被暂停。了解更多关于多个 User Profile 的速率限制处理。
平台分析数据速率限制
当社交网络对某个特定账号的分析数据调用进行限流时（与你的 Ayrshare User Profile 限制无关），也可能返回 HTTP429。这种情况下，响应会带有一个平台相关的 Ayrshare 错误码（例如 Facebook Page 级分析限流时的 code: 444）。请检查 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 遇到了内部错误或处理失败。