登录开始免费试用
easyCoexistence 官方 API

Instagram API 错误:常见错误代码的含义

最常见的 Instagram API 错误包括:190 表示访问令牌已过期或无效;4、17 和 80002 表示速率限制;9004 表示 Meta 无法获取媒体;9007 表示视频仍在处理中;9 表示每日发布上限;10 加子代码 2534022 表示私信超出消息窗口。每个错误都以 JSON 形式返回,包含 code、通常还有说明具体情况的 subcode,以及 message。

easyCoexistence 负责处理这些错误中与连接相关的部分:它会在 Instagram 访问权限过期之前续期,每 6 小时检查一次账户,并在需要重新连接时发送电子邮件通知您。

190

表示访问令牌已过期、被撤销或以其他方式失效的 Graph API 错误代码。

80002

Instagram Business Use Case 速率限制的错误代码。

2207042

错误代码 9 下的子代码,表示账户已达到每日 API 发布上限。

2207052

错误代码 9004 下的子代码,表示 Meta 无法从给定 URL 获取媒体。

2534041

错误代码 200 下的子代码,表示账户已关闭其 Instagram 消息的访问权限。

如何阅读 Instagram API 错误?

每个错误都是 error 下的一个 JSON 对象。code 是较宽泛的类别,error_subcode 指明具体情况,通常比 code 更有用,message 则对其作出描述。许多错误还带有面向终端用户的 error_user_title 和 error_user_msg 文字,以及 is_transient。fbtrace_id 用于标识该请求,供 Meta 支持团队查询,且会很快过期,因此请在错误发生时记录下来。

访问和权限错误是什么意思?

关于谁可以执行何种操作的错误,以及每种错误的修复方法:

  • 190:访问令牌已过期、被撤销或以其他方式失效;子代码 463 表示已过期,467 表示无效,460 表示密码已更改。获取新令牌即可解决,对于已连接的账户,这意味着重新连接。
  • 10:权限被拒绝。某项权限从未被授予,或之后已被移除。
  • 200 至 299:缺少某项特定权限,例如 200 加子代码 2534041,表示账户已关闭其消息的访问权限。
  • 25,子代码 2207050:账户受限、已停用或需要安全检查;账户所有者需要登录 Instagram 应用,并完成其要求的操作。

速率限制错误是什么意思?

这是限流,且全部为暂时性的:

  • 4:应用的调用次数过多;请等待后重试,或降低请求量。
  • 17:该用户的调用次数过多;处理方法相同。
  • 80002:Instagram Business Use Case 限制,按应用和账户的展示次数计算:每次展示在 24 小时内可进行 4,800 次调用。
  • 613,子代码 2534040:私信相关调用过多;请暂停,稍后再试。

与媒体相关的发布错误是什么意思?

这些错误与文件及其托管位置有关;按目前的情况,只有超时值得重试:

  • 9004,子代码 2207052:Meta 无法从该 URL 获取媒体;请确保链接有效且公开。
  • -2,子代码 2207003:下载耗时过长;这种情况值得再试一次。
  • 36000,子代码 2207004:图片超过 8 MB。
  • 36001,子代码 2207005:不支持该图片格式;请使用 JPEG。
  • 36003,子代码 2207009:宽高比超出 4:5 至 1.91:1 的范围。
  • 352,子代码 2207026:不支持该视频格式;请使用 MOV 或 MP4。

与时间和上限相关的发布错误是什么意思?

这些错误与时机和数量有关,大多可通过等待或重新开始解决:

  • 9007,子代码 2207027:媒体尚未就绪;请等待媒体容器的 status_code 显示为 FINISHED。
  • 24,子代码 2207008:媒体容器不存在或已过期;在 30 秒至 2 分钟内重试一两次,仍失败则创建新的容器。
  • -2,子代码 2207020:媒体已过期;请创建新的媒体容器。
  • 9,子代码 2207042:账户已达到每日发布上限;请于次日再试。
  • 100,子代码 2207028:轮播需要 2 至 10 项内容。
  • 36004,子代码 2207010:说明文字过长;Meta 的限制为 2,200 个字符和 20 个 @ 标签,其参考文档列出 30 个话题标签,但 Instagram 每篇帖子允许 5 个。
  • 4,子代码 2207051:Instagram 以疑似垃圾信息为由限制了该操作。

消息相关错误是什么意思?

来自私信和私密回复的错误:

  • 10,子代码 2534022:消息在允许的时间窗口之外发送;请等待对方再次发消息。
  • 100,子代码 2534014:找不到匹配的 Instagram 用户;请使用 Webhook 中的 Instagram 范围 ID,而非 Instagram 用户 ID。
  • 100,子代码 2534025:该评论无法接收私密回复。
  • 100,子代码 2534037:另一个应用(包括 Meta 自家的 Business AI)控制着该对话。
  • 551,子代码 1545041:该用户当前不可用。

洞察数据错误是什么意思?

洞察数据请求有三种有文档记载的失败方式:

  • 10,媒体的观看人数不足以显示洞察数据:限时动态的某项指标低于 5。
  • 已淘汰的指标(例如自 2025 年 4 月 21 日起的展示次数)会返回错误;请改为请求 views(观看次数)。
  • 当请求的多个指标中有某一项不支持所要求的细分时,会返回未知错误。

哪些错误值得重试?

只有暂时性的错误值得重试:代码 1 和 2、Instagram 服务器错误 2207001 和 2207032、下载超时 2207003、短暂的 2207008,以及速率限制在等待结束后。其他错误在文件、URL、权限、账户状态或私信时间窗口发生变化之前,都会返回相同的结果,重试这些错误只会消耗速率限制。

常见错误

  • 重试格式或大小错误。2207004、2207005、2207009 和 2207026 在媒体改变之前都会以同样方式失败。
  • 把 9007 当作失败。视频仍在处理中;请在容器显示 FINISHED 后再发布。
  • 只看错误代码。10 和 100 等代码涵盖多种情况,而子代码才能说明具体是哪一种。
  • 日志中省略 fbtrace_id。Meta 支持团队会要求提供该 ID,而它会在错误发生后很快过期。
使用 EasyCoexistence 完成这些操作

Claude、ChatGPT 或您自己的代码随后会使用保持更新的访问令牌调用 Meta 官方 API。每个连接每月 US$ 9 起,连接越多价格越低,最低降至 US$ 0.75,前 3 天免费。

常见问题

Instagram 上的错误 190 是什么意思?

访问令牌已过期、被撤销或以其他方式失效,例如更改密码之后。获取新令牌即可解决,对于已连接的账户,这意味着重新连接。

为什么发布时出现 9004 错误?

Meta 无法从给定的 URL 获取媒体,子代码 2207052。发布时请检查该链接是否有效且公开,并且前面没有登录页面。

9007 错误是什么?

媒体容器中的视频仍在处理中,子代码 2207027。请检查容器的 status_code,待其显示为 FINISHED 后再发布。

Instagram API 错误中的 fbtrace_id 是什么?

这是失败请求的标识符,报告问题时 Meta 支持团队会要求提供。它会在错误发生后很快过期,因此请当时就将其写入日志。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间