處理錯誤

對我們的 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：內部支援識別資料。在回報有關 Graph API 呼叫的錯誤時，請同時提供 fbtrace_id，以幫助我們找出除錯所需的記錄資料。不過，此編號很快會失效。為協助支援團隊重現您的問題，請附加已儲存的 Graph 測試工具連線階段。

錯誤代碼

代碼或類型	名稱	可採取的行動
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 OS 設定，以更新密碼。否則，他們必須再次登入應用程式。
463	已過期	登入狀態或存取憑證已過期、已撤銷，或因其他原因無效。請處理已過期的存取憑證。
464	用戶未確認	用戶需要前往 https://www.facebook.com 或 https://m.facebook.com 登入，才能校正這個問題。
467	存取憑證無效	存取憑證已過期、已撤銷，或因其他原因無效。請處理已過期的存取憑證。
492	作業階段無效	與專頁存取憑證相關的用戶沒有該專頁的合適角色。

限速錯誤代碼

請瀏覽 Graph API 限速指南，進一步了解限速錯誤代碼。