處理錯誤

對 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 限速」指南，瞭解有關限速錯誤代碼的更多資訊。