UapiProUApiPro
游戏

查询 MC 曾用名

0次调用
1 积分/次

想知道某个大佬以前叫什么名字吗？这个接口可以帮你追溯一个 Minecraft 玩家的“黑历史”！

功能概述

通过提供玩家的用户名或 UUID，你可以获取到该玩家所有曾用名及其变更时间的列表。这对于识别回归的老玩家或者社区管理非常有用。

使用须知

参数说明

  • name 和 uuid 二选一
  • UUID 支持带连字符（如 ee9b4ed1-aac1-491e-b761-1471be374b80）或不带连字符格式

响应结构差异

  • 使用 uuid 查询：返回单个用户的历史记录
  • 使用 name 查询：返回所有匹配用户的列表（包括当前用户名或曾用名匹配的玩家），需判断响应中是否有 results 字段来区分两种模式

查询参数

name
string可选

玩家的 Minecraft 用户名。使用此参数查询时，会返回所有匹配用户的列表（包括当前用户名或曾用名匹配的玩家）。

uuid
string可选

玩家的 Minecraft UUID，支持带连字符或不带连字符格式。

响应

200 / 请求成功

查询成功！根据查询方式返回不同结构：

  • uuid 查询：返回单个用户的历史记录
  • name 查询：返回匹配用户列表（判断响应中是否有 results 字段来区分）
JSON

400 / 错误的请求

请求失败。请检查你是否提供了 name 或 uuid 参数中的至少一个。

JSON

404 / 未找到

用户未找到。我们根据你提供的 UUID 未能找到对应的 Minecraft 玩家。请确认 UUID 是否正确。

JSON

502 / 网关错误

服务暂时不可用，请稍后重试。

JSON
下一篇查询 MC 服务器