快速开始

Minecraft个人资料API

获取任何Minecraft玩家的UUID、皮肤、披风和名称历史。一个URL，JSON响应。无需注册。

Minecraft API

发送第一个资料请求

使用用户名或玩家代号发送 HTTPS GET。选择 Java、Bedrock 或两者，并在读取标识符和资源前检查实际返回的版本对象。

GET https://vrc.lol/minecraft-api?username=Notch&type=all
Accept: application/json
JSONJava + Bedrock缓存状态无需 API 密钥

GET + HTTPS

全部端点

使用玩家资料端点获取 JSON 数据，使用资源端点获取可直接显示的 PNG 文件。

https://vrc.lol

GET

/minecraft-api?username=Notch&type=all

application/json: java | bedrock | cached

GET

/head?username=Notch&type=java&size=128

image/png: 8-512 px

GET

/skin?username=Notch&type=java

image/png: Java | Bedrock

GET

/cape?hash=HASH

image/png: cape

GET

/minecraft-api?suggest=Notch&limit=25

application/json: [{ username, types }]

GET

/skin_body?username=Notch&type=java&size=160

image/png: 40-200 px

请求选项

当应用需要可预测的结果时，请明确指定标识符和版本。

username

name | gamertag | UUID | XUID

type

all | java | bedrock

suggest

search text + limit 1-100

update

true · 3600s profile cooldown

代码示例

这些请求使用 Minecraft 专用端点，并且不需要 API 密钥。

JavaScript

const response = await fetch('https://vrc.lol/minecraft-api?username=jeb_&type=all');
const profile = await response.json();
console.log(profile.java?.uuid);

Python

import requests
profile = requests.get('https://vrc.lol/minecraft-api', params={'username': 'jeb_', 'type': 'all'}).json()
print(profile.get('java', {}).get('uuid'))

cURL

curl -sS 'https://vrc.lol/minecraft-api?username=jeb_&type=all'

响应格式

{
  "success": true,
  "cached": true,
  "java": { "username": "jeb_", "uuid": "...", "skin_url": "...", "cape_url": "..." },
  "bedrock": { "username": "...", "xuid_decimal": "...", "floodgate_uuid": "..." }
}

java | bedrock: optional object; fields may be null

HTTP状态码

200 OK

application/json | image/png

400 Bad Request

code: MISSING_PARAMETER | INVALID_INPUT_FORMAT | INVALID_TYPE_FILTER

404 Not Found

code: CACHE_PROFILE_NOT_FOUND | TEXTURE_NOT_FOUND | CAPE_NOT_FOUND

429 Too Many Requests

Retry-After

500 Internal Server Error

{ "success": false, "error": "..." }

请求速率限制

常见问题

API需要密钥吗？

不需要。Minecraft个人资料API免费且无需密钥。

基础URL是什么？

以 https://vrc.lol 为基础 URL，并搭配 /minecraft-api、/head、/skin 和 /cape 使用。

可以通过UUID查询吗？

在 username 参数中传入 UUID，例如 /minecraft-api?username=853c80ef3e3740fdaa867b06307a3d4f。

UUID格式 — 带连字符还是不带？

支持无连字符和带连字符的 UUID。

使用场景

Discord

/minecraft-api | /head

CORS + JSON

fetch() | application/json

UUID + XUID

permissions.json | cache

后续步骤

VRC.LOL · Discord

加入我们的Discord

寻求帮助、分享反馈，并认识VRC.LOL社区。

加入我们的Discord