错误代码参考

Leaderboards and Tournaments API请求可能会导致Leaderboards and Tournaments服务的错误响应。每个错误响应都包括一个错误代码，用于指示特定类型的错误。以下示例显示了错误响应消息正文中的字段：

{
    "errorCode"： 207,
    "message"： “玩家没有剩余的尝试次数，无法进入所提供“matchId”。”，
    “request_id”： “20de6268-31b3-4bea-beea-9c9c8b594fc5"
}

字段	描述
errorCode	用于标识特定错误的唯一编号。
消息	对错误的描述。参见下面的注释。
request_id	导致错误响应的请求ID。如果您需要支持，请与Leaderboards and Tournaments支持部门分享请求ID，以帮助识别导致错误的具体请求。

注意： 错误代码值不会更改，因此您可以在游戏软件中检查特定值。错误消息中的文本可能会随时间推移而更新（以提高可读性或实用性），因此不要在游戏软件和任何消息字段的特定文本内容之间建立任何依赖关系。

下表包含错误代码的完整列表。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	出现一个或多个验证错误：“错误列表”。
4	400	无法解析请求正文。验证语法是否为有效的JSON，然后重试。
5	400	“content-type”缺失或无效。在content-type标头中提供application/json的有效内容类型。
6	400	必要标头/参数缺失或无效。提供缺失的标头/参数。
7	400	在该终端节点上方法“该方法”不受支持。支持的方法包括：“支持的方法的列表”。
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	如果竞赛未处于“打开”或“关闭”状态，则无法将队伍从竞赛中删除。
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	玩家已经加入了本次竞赛中允许每个玩家参加的最大数量比赛。
225	409	已领取所有奖品。
300	404	未找到所提供的“prizeId”。
400	404	未找到所提供“requirementId”。
801	404	具有所提供“sessionId”的玩家未在所提供“teamId”中。
802	404	无法找到所提供“teamId”。