注

これはマッチメイキングAPIを使用する際に参照する情報を説明しています。

エラーコード¶

マッチメイキングAPIリクエストが正しく処理されない場合、原因を特定するためにHTTPレスポンスステータスコードに加えて別のエラーコードを提供します。

エラーコードは、各マッチメイキングAPIリクエストのレスポンス値として確認でき、以下のJSONデータ形式で構成されています。

// 예시)
{
    "code": 11001,
    "reason": "already group member"
}

Note

エラーコードレスポンスでは、各codeの値は固定されていますが、reason（エラーの原因）はAPIの更新に応じて変更される可能性があります。

APIレスポンスエラーに従って提供されるエラーコードの種類は以下の通りです。

コード	説明
1000	内部サーバーシステムエラー
1001	リクエストデータのボディの値に有効性の問題があります
1002	APIサーバーエラー
1100	HTTPメソッド - GETを使用するAPIで、必須のPARAM値が欠落している場合

コード	説明
2000	`Hive Certification Key` が欠落しています
2001	`Hive Certification Key` の値が不正です
2002	`gameIndex` の値が不正です
2100	このAPIは利用できません
2200	認証確認のためのデータが利用できません
2201	認証確認に使用されるデータがサポートされていない形式です
2300	Hive SDK 認証に使用されるデータが不正です
2310	登録されていない `appId` です
2320	実際の Hive SDK Auth リクエストの作成に失敗しました

コード	説明
3000	APIユーザーに関する情報を取得できませんでした
3001	APIパスから`gameIndex`値を取得できませんでした
3002	APIパスから`matchId`情報を取得できませんでした
3003	リクエストボディの内容を読み取れません（解析の問題）
3004	リクエストから`playerId`情報を取得できませんでした
3005	リクエストから`targetPlayerId`情報を取得できませんでした

コード	説明
4000	`matchId` 情報を取得できません
4001	API パスから `gameIndex` 値を取得できません
4100	`matchId` を作成または変更するために必要な情報が正しくありません

コード	説明
10000	一致するリクエストはすでに進行中です（重複リクエスト）
10100	一致するリクエストを削除する際、削除するリクエストはありません

コード	説明
11000	グループの一部ではありません
11001	すでにグループに所属しています
11002	このグループのメンバーではありません
11003	グループリーダーではありません
11004	入力されたコードに対応するグループが見つかりません
11005	グループに所属している間は使用できません
11006	（グループ）マッチング中は使用できません
11100	（個別）マッチングが進行中のため作成できません
11101	チームマッチングでない場合は作成できません
11200	グループマッチングが進行中です（重複）
11201	準備ができていないメンバーがいます
11202	他のメンバーがいません（単独ではリクエストできません）
11300	進行中のマッチングのため変更できません
11301	グループリーダーは変更できません
11400	メンバーが満員のため参加できません
11401	マッチングルールに基づく制限のため参加できません（スコアなど）
11402	`matchId`は別のグループに参加できません
11500	準備ができているメンバーは退会できません
11600	削除するマッチングリクエストはありません
11700	グループリーダーは強制的に追放できません