- Code - サーバーが返す HTTP エラーコード
- ErrorCode - PlayFab 固有の数値エラーコード。
- Error - PlayFab 固有の、人間が読めるコード。
- ErrorMessage - デバッグに役立つ追加のコンテキストを提供するエラーの説明。
- ErrorDetails - 常に存在するわけではありません。特定の種類のエラーに対して追加のコンテキストを提供します。
このページには、遭遇する可能性のある一般的なエラーコードを掲載しています。探しているエラーコードがこのページにない場合は、より一般的な HTTP レスポンスステータスコードガイダンス を参照してください。
安全にリトライできるコード
これらのエラーコードで失敗したリクエストは、指数関数的な遅延バックオフを伴って再試行しても通常安全です。これらのエラーは通常、クライアントが呼び出しをあまりにも速く行っていることを意味しますが、リクエスト自体は有効である可能性があります。APIClientRequestRateLimitExceeded (1199): 短時間に多数の呼び出しが行われたことを示します。APIConcurrentRequestLimitExceeded (1342): 同時 呼び出しが多すぎることを示します。ConcurrentEditError (1133): 同時 呼び出しが多すぎるか、非常に高速な 連続 呼び出しがあることを示します。DataUpdateRateExceeded (1287): 同時呼び出し が多すぎるか、非常に高速な 連続 呼び出しがあることを示します。DownstreamServiceUnavailable (1127): PlayFab またはサードパーティサービスに一時的な問題が発生している可能性があることを示します。ServiceUnavailable (1123): PlayFab に一時的な問題が発生しているか、クライアントが API 呼び出しをあまりにも速く行いすぎている可能性があることを示します。このリクエストを再試行する場合は、指数関数的バックオフ戦略を適切に使用することが重要です。
決してリトライしないコード
これらのエラーコードを取得した場合は、バグ修正または設定変更を行わない限り、現在の状況下でリクエストを完了できないため、絶対に 再試行しないでください。 API メソッドと共にリストされているほとんどの 特定 のコードもこのカテゴリに該当します。AccountBanned (1002):
プレイヤーアカウントが BAN されており、すべての API メソッドがこのエラーで失敗します。AccountDeleted (1322): プレイヤーアカウントが削除されており、すべての API メソッドがこのエラーで失敗します。AccountNotFound (1001): プレイヤーアカウントが存在しません。多くの場合、PlayFabId/TitlePlayerIdを正しくコピーしていないことが原因です。識別子が正しくない場合、このエラーは常に発生します。APIRequestsDisabledForTitle (1295): このタイトルのすべての API リクエストが無効化されており、このタイトルはこれ以上使用できません。InvalidContentType (1144): 当社の SDK のいずれかを使用している場合、このエラーが発生することはないはずです。PlayFab API メソッドへの独自の生の HTTPS 呼び出しを行っている場合、Content-Typeヘッダーはapplication/jsonである必要があります。その他の形式は受け付けられません。InvalidEntityType (1373): 認証に使用したトークン内のエンティティタイプが、この API でサポートされていません。InvalidParams (1000): PlayFab に送信された API リクエストオブジェクトのパラメーターが無効なため、実行できません。InvalidRequest (1071): PlayFab に送信された API リクエストオブジェクトが無効なため、実行できません。InvalidTitleId (1004): リクエストで指定された TitleId が、メソッドの URL で指定されたタイトルと一致 しません。ほとんどの SDK では、ログインリクエストに対して TitleId を指定する必要はありません (自動的に行われます)。管理 API では、明示的な TitleId は Dev->Test->Live の安全機能です。NotAuthenticated (1074): クライアントは、事前にログインせずにSessionTicket認証を必要とする API を呼び出そうとしました。NotAuthorized (1089): 認証情報が正しくないか、ログインに関連するその他の不適切な入力です。NotAuthorizedByTitle (1191): このメソッドは API ポリシーによって無効化されており、呼び出すことはできません。ProfileDoesNotExist (1298): 存在しないエンティティ (プレイヤー、キャラクター、タイトルなど) へのアクセスを試みました。おそらくタイプミスか、どこかで不正な入力があります。TitleDeleted (1347): このタイトルは PlayFab から削除されており、これ以上使用できません。UnknownError (1039): これは通常、サードパーティのアドオンに不適切な情報が送信され、サーバーが外部システムとやり取りする際に不明な結果またはエラーが発生した場合に起こります。解決するには、入力を変えて試し、入力が何らかの点で無効かどうかを判断してください。それでも解決しない場合は、titleId、完全なリクエスト JSON (可能であれば)、およびエラー出力を添えてフォーラムでエラーを報告してください。この状況のデバッグには Postman が便利なツールです。InvalidAPIEndpoint (1131): このリクエストの URL がこのタイトルに対して有効でないことを示します。OverLimit (1214): 操作を実行しようとするとサービスの使用量が Game Manager の制限ページに表示されている制限を超過することを示します。返されたエラー詳細を評価して、どの制限を超過するかを判断してください。
その他の注目すべきエラーコード
これらのコードは特定の API メソッド (それらのメソッドのドキュメントページにリストされています) でのみ発生しますが、これらを見た場合は、認識しておくべき重要な影響があります。APIConcurrentRequestLimitExceeded (1342): タイトルが CloudScript を過剰に呼び出しているか、セグメント評価を強制的に頻繁に実行しようとしている (またはその両方) 場合です。前者について、確認すべき 2 点は次のとおりです。- スクリプト呼び出しが呼び出しごとに最大時間近くを使用する頻度 (あるいはタイムアウトする頻度)。
- プレイヤーごとに CloudScript を呼び出す頻度。セグメント内のプレイヤー一覧を取得する呼び出しは特に確認すべき重要な項目です (セグメントを対象とするタスクも再評価を引き起こしますが、これは頻繁ではないはずです)。
ConnectionTimeout (2): 使用している SDK の詳細や、その基盤となるネットワークスタックによっては、ConnectionError、ConnectionTimeout、その他 PlayFab サーバーへの接続の困難さに関連するエラーが発生する可能性があります。これらはすべてネットワークの問題を示しています。最も一般的な原因はクライアント側の切断です。クライアントと PlayFab サーバー間のインターネットルーティングが何らかの理由で中断された場合にも発生する可能性があります。ゲームがこれらのエラーを処理するためにできることはほとんどありません。最善の対応は、上流の呼び出し元やプレイヤーに、接続を確立できないことを知らせることです。その後、後で操作を再開できます。