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