游戏

查询 MC 玩家

0次调用
1 积分/次

只需要一个玩家的用户名,就能快速获取到他的正版皮肤和独一无二的UUID!

GET
uapis.cn
/api/v1/game/minecraft/userinfo
查询参数
1
username
string
required

玩家的 Minecraft 游戏内名称(正版ID)。

功能概述

这是一个基础但非常实用的接口。通过玩家当前的游戏内名称(Username),你可以查询到他对应的UUID(唯一标识符)和当前皮肤的URL地址。这是构建许多其他玩家相关服务的第一步。

查询参数

username
string必填

玩家的 Minecraft 游戏内名称(正版ID)。

响应

200 / 请求成功

查询成功!返回用户的UUID和皮肤链接。

JSON
{
  // 玩家当前使用的皮肤图片URL。
  "skin_url": "http://textures.minecraft.net/texture/292009a499420915b854a9913d9fa92750175814529452a55982791844863f53",
  // 玩家当前的准确用户名(注意大小写可能与输入不同)。
  "username": "Notch",
  // 玩家的32位无破折号UUID。
  "uuid": "ee9b4ed1aac1491eb7611471be374b80"
}

400 / 错误的请求

请求失败。请检查你是否提供了 username 参数。

JSON
{
  "code": "INVALID_ARGUMENT",
  "details": {},
  "message": "Missing 'username' parameter."
}

404 / 未找到

玩家未找到。根据你提供的用户名,未能找到对应的 Minecraft 玩家。请检查拼写是否正确。

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

502 / 网关错误

暂时无法获取相关游戏数据,请稍后重试。

JSON
{
  "code": "UPSTREAM_ERROR",
  "details": {},
  "message": "Unable to fetch game data. Please try again later."
}