跳轉至

這解釋了在使用配對 API 時參考的信息。

錯誤代碼

如果配對 API 請求未正確處理,它會提供一個單獨的錯誤代碼,除了 HTTP 響應狀態碼,以幫助識別原因。

錯誤代碼可以作為每個配對 API 請求的回應值進行檢查,並以以下 JSON 數據格式結構化。

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

在錯誤代碼回應中,每個 code 的值是固定的,但 reason(錯誤原因)可能會根據 API 更新而修改。

根據API響應錯誤提供的錯誤代碼類型如下。

一般錯誤代碼

代碼 描述
1000 內部伺服器系統錯誤
1001 請求數據中的 body 值存在有效性問題
1002 API 伺服器錯誤
1100 在使用 HTTP 方法 - GET 的 API 中,如果缺少必需的參數值

API 認證錯誤代碼

代碼 描述
2000 Hive Certification Key 缺失
2001 Hive Certification Key 的值不正確
2002 gameIndex 的值不正確
2100 此 API 不可用
2200 用於身份驗證驗證的數據不可用
2201 如果用於身份驗證驗證的數據格式不受支持
2300 用於 Hive SDK 身份驗證的數據不正確
2310 不是已註冊的 appId
2320 無法發送實際的 Hive SDK 認證請求

API 常見錯誤代碼

代碼 描述
3000 無法獲取有關 API 使用者的信息
3001 無法從 API 路徑檢索 gameIndex
3002 無法從 API 路徑檢索 matchId 信息
3003 無法讀取請求主體的內容(解析問題)
3004 無法從請求中獲取 playerId 信息
3005 無法從請求中獲取 targetPlayerId 信息

與匹配 ID (matchId) 相關的錯誤代碼

代碼 描述
4000 無法檢索 matchId 資訊
4001 無法從 API 路徑獲取 gameIndex
4100 創建或修改 matchId 所需的資訊不正確

個人 API 相關錯誤代碼

代碼 描述
10000 匹配請求已在進行中(重複請求)
10100 刪除匹配請求時,沒有請求可以刪除

群組 API 相關錯誤代碼

代碼 描述
11000 不在該群組內
11001 已經在一個群組中
11002 不是此群組的成員
11003 不是群組領導者
11004 找不到與輸入代碼相對應的群組
11005 在屬於群組時無法使用
11006 在(群組)匹配期間無法使用
11100 在(個人)匹配進行中無法創建
11101 如果不是團隊匹配則無法創建
11200 群組匹配進行中(重複)
11201 有未準備的成員
11202 沒有其他成員(單獨請求不可能)
11300 由於正在進行的匹配無法更改
11301 群組領導者無法更改
11400 由於成員已滿無法參加
11401 由於基於匹配規則的限制(分數等)無法參加
11402 matchId 不能參加另一個群組
11500 準備好的成員無法離開
11600 沒有要刪除的匹配請求
11700 群組領導者無法強制驅逐