UapiProUApiPro
游戏

查询 MC 曾用名

0次调用
1 积分/次

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

GET
uapis.cn
/api/v1/game/minecraft/historyid
查询参数
2
uuid
string

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

name
string
Pro

玩家的 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
{
  // 【name 查询时返回】查询的用户名。
  "query": "ExamplePlayer",
  // 【name 查询时返回】匹配到的用户数量，为 0 时表示未找到。
  "count": 2,
  // 【name 查询时返回】匹配用户列表，包含当前用户名或曾用名匹配的所有玩家。
  "results": [
    {
      // 玩家当前的用户名。
      "id": "ExamplePlayer",
      // 玩家的UUID（带连字符格式）。
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      // 历史名称的总数。
      "name_num": 1,
      // 历史用户名数组。
      "history": [
        {
          "name": "ExamplePlayer",
          "changedToAt": "2023/09/13 10:10:06"
        }
      ]
    }
  ],
  // 【uuid 查询时返回】玩家当前的用户名。
  "id": "T8K_",
  // 【uuid 查询时返回】被查询玩家的UUID（带连字符格式）。
  "uuid": "ee9b4ed1-aac1-491e-b761-1471be374b80",
  // 【uuid 查询时返回】历史名称的总数（包含当前名称）。
  "name_num": 4,
  // 【uuid 查询时返回】包含所有历史用户名的数组，按时间倒序排列。
  "history": [
    {
      // 更名为此名称的时间，格式为 `YYYY/MM/DD HH:mm:ss`。如果是初始名称，则为 `Initial`。
      "changedToAt": "2015/02/04 22:42:25",
      // 当时使用的用户名。
      "name": "jeb_"
    }
  ]
}

400 / 错误的请求

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

JSON
{
  "code": "INVALID_ARGUMENT",
  "details": {},
  "message": "uuid or name query parameter is required"
}

404 / 未找到

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

JSON
{
  "code": "NOT_FOUND",
  "details": {},
  "message": "User with the specified UUID not found."
}

502 / 网关错误

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

JSON
{
  "code": "UPSTREAM_ERROR",
  "details": {},
  "message": "Service temporarily unavailable."
}
下一篇查询 MC 服务器
免费Minecraft玩家曾用名查询API - MC历史用户名追溯 | UAPI