註
這解釋了在使用配對 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 | 群組領導者無法強制驅逐 |