Instagram API 错误:常见错误代码的含义
最常见的 Instagram API 错误包括:190 表示访问令牌已过期或无效;4、17 和 80002 表示速率限制;9004 表示 Meta 无法获取媒体;9007 表示视频仍在处理中;9 表示每日发布上限;10 加子代码 2534022 表示私信超出消息窗口。每个错误都以 JSON 形式返回,包含 code、通常还有说明具体情况的 subcode,以及 message。
easyCoexistence 负责处理这些错误中与连接相关的部分:它会在 Instagram 访问权限过期之前续期,每 6 小时检查一次账户,并在需要重新连接时发送电子邮件通知您。
表示访问令牌已过期、被撤销或以其他方式失效的 Graph API 错误代码。
Instagram Business Use Case 速率限制的错误代码。
错误代码 9 下的子代码,表示账户已达到每日 API 发布上限。
错误代码 9004 下的子代码,表示 Meta 无法从给定 URL 获取媒体。
错误代码 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,而它会在错误发生后很快过期。
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 监控
验证时间