エラーコードリファレンス

Leaderboards and Tournaments APIリクエストに対して、Leaderboards and Tournamentsサービスからエラーレスポンスが返されることがあります。各エラーレスポンスには、エラーの種類を特定するエラーコードが含まれます。エラーレスポンスのメッセージ本文には、次のようなフィールドがあります。

{
    "errorCode": 207,
    "message": "プレイヤーに試行回数が残っていないため、指定された「matchId」に参加できません。",
    "request_id": "20de6268-31b3-4bea-beea-9c9c8b594fc5"
}

フィールド	説明
errorCode	エラーを識別する一意の番号。
message	エラーの説明。下記の「注」を参照してください。
request_id	エラーレスポンスが返されたリクエストのID。サポートが必要な場合は、このリクエストIDをLeaderboards and Tournamentsサポートに連絡して、エラーの原因となったリクエストの特定に役立てることができます。

注：エラーコードの値が変更されることはないため、ゲームソフトウェアで特定の値をチェックして処理に利用できます。一方、エラーメッセージのテキストは適宜更新される可能性があります（わかりやすさや有用性の向上のため）。ゲームソフトウェアでは、メッセージフィールドの特定のテキストコンテンツに依存しないようにしてください。

以下の表は、すべてのエラーコードを示したものです。Leaderboards and Tournaments APIリファレンスには、各APIリクエストから返される可能性のある特定のエラーコードの一覧が記載されています。

エラーコード	HTTPコード	エラーの説明
0	500	不明なエラーが発生しました。このエラーが解決しない場合は、Leaderboards and Tournamentsサポートにお問い合わせください。
1	[401, 403]	無効なx-api-keyです。x-api-keyヘッダーに有効なAPIキーを指定してください。
2	401	session-idが無効または期限切れです。session-idヘッダーに有効なセッションIDを指定してください。
3	400	1つ以上の検証エラーが発生しました：「エラーのリスト」
4	400	リクエストの本文を解析できません。構文が有効なJSONであることを確認し、再試行してください。
5	400	「content-type」が見つからないか無効です。content-typeヘッダーに有効なコンテンツタイプ（application/json）を指定してください。
6	400	必要なヘッダーまたはパラメーターが見つからないか無効です。不足しているヘッダーまたはパラメーターを指定してください。
7	400	メソッド「this method」はこのエンドポイントでサポートされていません。サポートされているメソッドは次のとおりです：「サポートされているメソッドのリスト」
8	429	送信されたリクエストが多すぎます。
9	404	指定された「gameId」が見つかりませんでした。
10	500	依存サービスの呼び出し中にエラーが発生しました。
11	403	プレイヤーはトーナメント作成者によって利用を禁止されているため、このアクションを実行できません。誤って利用禁止にされていると考えられる場合は、サポートにお問い合わせください。
100	400	指定された「encryptedPayload」を復号化できませんでした。登録時に提供されたゲームパブリックキーでペイロードが暗号化されていることを確認してください。
101	400	「encryptedPayload」がありません。登録時に提供されたゲームパブリックキーでペイロードが暗号化されていることを確認してください。
102	400	指定された「encryptedPayload」は正常に復号化されましたが、ペイロードの内容が有効なパブリックキーで構成されていませんでした。ゲームパブリックキーで暗号化する前に、ペイロードが有効なパブリックキーであることを確認してください。
103	400	指定された「encryptedPayload」は正常に復号化されました。ペイロードの内容は有効なパブリックキーで構成されていますが、キーのサイズが2048ビット以上ではありませんでした。
104	400	指定された「encryptedPayload」を復号化できなかったか、内容が有効なパブリックキーで構成されていません。登録時に提供されたゲームパブリックキーでペイロードが暗号化されていることを確認してください。
105	401	指定された「playerToken」を持つプレイヤーが見つかりませんでした。
106	400	指定された「playerToken」は無効です。トークンが有効なUUIDであることを確認してください。
107	403	プレイヤーは利用を禁止されているため、このアクションを実行できません。誤って利用禁止にされていると考えられる場合は、サポートにお問い合わせください。
108	404	指定された「externalPlayerId」のプレイヤーが見つかりませんでした。
109	401	指定された「sessionId」のセッションが見つかりませんでした。
110	401	指定された「sessionId」のセッションは期限切れです。新しいセッションのためにプレイヤーを再認証してください。
111	401	無効なx-api-keyまたはexternalGameIdです。x-api-keyヘッダーに有効なAPIキーを指定するか、パスに有効なexternalGameIdを指定してください。
200	404	指定された「tournamentId」のトーナメントが見つかりませんでした。
201	404	指定された「matchId」のマッチが見つかりませんでした。
202	404	指定された「matchId」に、指定された「playerId」のプレイヤーが見つかりませんでした。
203	409	最大試行回数を超えました。
204	409	指定された「tournamentId」は既に開始されているため、アクションを実行できません。
205	409	指定された「tournamentId」は既に終了しているため、アクションを実行できません。
206	409	トーナメントの開始前に参加することはできません。
207	409	プレイヤーに試行回数が残っていないため、指定された「matchId」に参加できません。
208	409	指定された「playerAttributes」によると、プレイヤーは参加要件を満たしていません。
209	409	このプレイヤーはストリーミングプラットフォームのアカウントとリンクしていないため、トーナメントに参加できません。
210	409	指定された「sessionId」を持つプレイヤーは、トーナメントに必要なアクセスキーを使用しませんでした。
211	409	指定された「sessionId」を持つプレイヤーは、トーナメントのアクセスキーと一致しないアクセスキーを使用しました。
212	409	指定された「teamId」はトーナメントのサイズ要件を満たしていません。トーナメントには「最小チームサイズ」から「最大チームサイズ」の範囲でチームサイズを設定する必要があります。指定された「teamId」には「チームサイズ」の最大サイズが設定されています。
213	409	指定された「tournamentId」には参加できるマッチがありません。
214	409	トーナメントのステータスが「OPEN」または「CLOSED」でない場合、トーナメントからチームを削除することはできません。
215	404	指定された「tournamentId」は「クリエイタータイプ」のトーナメントではありません。
216	409	指定された「sessionId」を持つプレイヤーに、指定された「tournamentId」をアップデートするために必要なパーミッションがありません。
217	409	開始されていないトーナメントを終了することはできません。
218	409	指定された「tournamentId」は終了しているため、再度終了することはできません。
219	409	指定された「tournamentId」は現在処理中です。しばらく待ってからトーナメントの終了を再試行してください。
220	404	指定された「sessionId」と「tournamentId」に、指定された「teamId」が見つかりませんでした。
221	404	最大人数に達しているため、トーナメントに参加できません。
222	404	トーナメントの終了後に参加することはできません。
223	403	指定されたsessionIdはこのリソースに対して有効ではありません。
224	404	プレイヤーの参加したマッチの数が、このトーナメントで1人のプレイヤーが参加できる最大数に達しました。
225	409	すべての賞品は請求済みです。
300	404	指定された「prizeIds」が見つかりません。
400	404	指定された「requirementIds」が見つかりません。
801	404	指定された「teamId」に、指定された「sessionId」を持つプレイヤーが存在しません。
802	404	指定された「teamId」が見つかりませんでした。