グラフAPI

エラーの処理

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: 内部サポートID。グラフAPI呼び出しに関する不具合を報告する際、fbtrace_idを含めて、Facebookがデバッグ用のログデータを見つけられるようにしてください。ただし、このIDは間もなく期限切れになります。サポートチームが問題を再現できるようにするため、保存したグラフエクスプローラーのセッションを添付してください。

エラーコード

コードまたはタイプ 名前 対処法

OAuthException

サブコードがない場合、ログインステータスかアクセストークンの有効期限が切れているか、取り消されているか、無効になっています。新しいアクセストークンを取得してください。

サブコードがある場合は、サブコードを確認します。

102

APIセッション

サブコードがない場合、ログインステータスかアクセストークンの有効期限が切れているか、取り消されているか、無効になっています。新しいアクセストークンを取得してください。

サブコードがある場合は、そのサブコードを確認します。

1

API Unknown (API不明)

ダウンタイムによる一時的な問題である可能性があります。しばらく待ってから操作を再試行してください。問題が再発する場合は、既存のAPIをリクエストしていることを確認します。

2

API Service (APIサービス)

ダウンタイムによる一時的な問題です。しばらく待ってから操作を再試行してください。

3

API Method (APIメソッド)

機能またはアクセス許可の問題です。アプリに、この呼び出しを行うのに必要な機能またはアクセス許可があることを確認します。

4

API Too Many Calls (APIの呼び出し回数が上限を超えました)

スロットリングによる一時的な問題です。しばらく待ってから操作を再試行するか、APIリクエストのボリュームを確認してください。

17

API User Too Many Calls (API利用者の呼び出し回数が上限を超えました)

スロットリングによる一時的な問題です。しばらく待ってから操作を再試行するか、APIリクエストのボリュームを確認してください。

10

API Permission Denied (APIのアクセス許可が拒否されました)

アクセス許可が付与されていないか、削除されています。不足しているアクセス許可を処理してください。

190

Access token has expired (アクセストークンが有効期限切れになっています)

新しいアクセストークンを取得してください。

200-299

API Permission (APIのアクセス許可)(アクセス許可により複数の値)

アクセス許可が付与されていないか、削除されています。不足しているアクセス許可を処理してください。

341

Application limit reached (アプリケーションの上限に達しました)

ダウンタイムまたはスロットリングによる一時的な問題です。しばらく待ってから操作を再試行するか、APIリクエストのボリュームを確認してください。

368

Temporarily blocked for policies violations (ポリシーに違反しているため一時的にブロックされています)

しばらく待ってから操作を再試行してください。

506

Duplicate Post (重複する投稿)

重複する投稿を連続して公開することはできません。投稿の内容を変更して、もう一度実行してください。

1609005

Error Posting Link (投稿リンクのエラー)

提供されたリンクからデータを取得中に問題が発生しました。URLを確認して再試行してください。

サブコードの認証エラー

コード 名前 対処法

458

App Not Installed (アプリがインストールされていません)

ユーザーがアプリにログインしていません。ユーザーを再認証します。

459

User Checkpointed (利用者のチェックポイントが設定されています)

問題を修正するには、ユーザーがhttps://www.facebook.comまたはhttps://m.facebook.comにログインする必要があります。

460

Password Changed (パスワードが変更されました)

iOS 6以上で、利用者がOSに統合されたフローでログインしている場合、デバイスのFacebook OS設定を表示し、そこでパスワードを更新できるようにする必要があります。あるいは、アプリにもう一度ログインする必要があります。

463

Expired (期限切れ)

ログインステータスかアクセストークンの有効期限が切れているか、取り消されているか、または無効になっています。期限切れアクセストークンを処理してください。

464

Unconfirmed User (未確認の利用者)

問題を修正するには、ユーザーがhttps://www.facebook.comまたはhttps://m.facebook.comにログインする必要があります。

467

Invalid access token (アクセストークンが無効です)

アクセストークンの有効期限が切れているか、取り消されているか、または無効になっています。期限切れアクセストークンを処理してください。

492

Invalid Session (セッションが無効です)

ページアクセストークンに関連付けられているユーザーに、そのページに対する適切な役割がありません。

レート制限エラーコード

レート制限エラーコードについて詳しくは、グラフAPIレート制限ガイドをご覧ください。