处理错误

向我们的 API 发出的请求可能会产生多种不同的错误响应。以下文档会说明恢复策略，并提供错误值列表和包含最常用恢复策略的地图。

错误响应

以下展示了 API 请求失败导致的一个常见错误响应：

{
  "error": {
    "message": "Message describing the error", 
    "type": "OAuthException", 
    "code": 190,
    "error_subcode": 460,
    "error_user_title": "A title",
    "error_user_msg": "A message",
    "fbtrace_id": "EJplcsCHuLu"
  }
}

message：易于用户阅读的错误说明。
code：错误代码。下方列出了常见值以及常用恢复策略。
error_subcode：有关错误的其他信息。下方列出了常见值。
error_user_msg：向用户显示的消息。消息语言以 API 请求的区域设置为依据。
error_user_title：代表对话框的标题（如显示）。消息语言以 API 请求的区域设置为依据。
fbtrace_id：内部支持标识符。报告与图谱 API 调用相关的漏洞时，提供 fbtrace_id 可帮助我们查找用于调试的日志数据。但是，此编号很快就会过期。为帮助支持团队重现您的问题，请附上保存的图谱探索工具会话。

错误代码

代码或类型	名称	解决方案
OAuthException		如果不存在子代码，则表示登录状态或访问口令已过期、被撤销或无效。获取新访问口令。如果存在子代码，请查看子代码。
102	API 会话	如果不存在子代码，则表示登录状态或访问口令已过期、被撤销或无效。获取新访问口令。如果存在子代码，请查看子代码。
1	API 未知	可能是停机导致的临时问题。等待并重试操作。如果问题再次出现，请检查您是否在请求现有 API。
2	API 服务	停机导致的临时问题。等待并重试操作。
3	API 方法	功能或权限问题。如要发出此调用，请确保您的应用具有必备功能或权限。
4	API 调用过多	节流导致的临时问题。等待并重试操作，或检查 API 请求量。
17	API 用户调用过多	节流导致的临时问题。等待并重试操作，或检查 API 请求量。
10	API 权限被拒绝	未获得权限或权限已被移除。处理缺失的权限。
190	访问口令已过期	获取新访问口令。
200-299	API 权限（多个值，取决于权限）	未获得权限或权限已被移除。处理缺失的权限。
341	达到应用程序上限	停机或节流导致的临时问题。等待并重试操作，或检查 API 请求量。
368	因违反政策被暂时禁用	等待并重试操作。
506	重复帖子	不能连续发布重复的帖子。更改帖子内容并重试。
1609005	发布链接错误	从提供的链接中搜刮数据时出错。检查网址并重试。

身份验证错误子代码

代码	名称	解决方案
458	应用未安装	用户尚未登录应用。重新验证用户身份。
459	用户抽点检查	用户需要登录 https://www.facebook.com 或 https://m.facebook.com 纠正问题。
460	密码已更改	在 iOS 6 及以上版本中，如果用户使用操作系统集成的流程登录，请将其定向至设备上的 Facebook 操作系统设置以更新密码。否则，用户必须重新登录应用。
463	已过期	登录状态或访问口令已过期、被撤销或无效。处理过期的访问口令。
464	用户未确认	用户需要登录 https://www.facebook.com 或 https://m.facebook.com 纠正问题。
467	访问口令无效	访问口令已过期、被撤销或无效。处理过期的访问口令。
492	会话无效	与主页访问口令相关联的用户在主页上不具有相应身份。

流量限制错误代码

访问图谱 API 流量限制指南，了解更多关于流量限制错误代码的信息。