Schnellstart

Minecraft Profil-API

UUID, Skin, Cape und Namenshistorie für jeden Minecraft-Spieler abrufen. Eine URL, JSON-Antwort. Ohne Anmeldung.

Minecraft API

Erste Profilabfrage senden

Sende eine HTTPS-GET-Anfrage mit Name oder Gamertag. Wahle Java, Bedrock oder beide und prufe das vorhandene Editionsobjekt vor seinen Kennungen und Dateien.

GET https://vrc.lol/minecraft-api?username=Notch&type=all
Accept: application/json
JSONJava + BedrockCache-StatusKein API-Schlussel

GET + HTTPS

Alle Endpunkte

Verwende den Profil-Endpunkt für JSON-Daten und die Asset-Endpunkte für direkt nutzbare PNG-Dateien.

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

Anfrageoptionen

Gib Kennung und Edition ausdrücklich an, wenn deine Anwendung vorhersehbare Ergebnisse benötigt.

username

name | gamertag | UUID | XUID

type

all | java | bedrock

suggest

search text + limit 1-100

update

true · 3600s profile cooldown

Codebeispiele

Diese Anfragen verwenden den Minecraft-Endpunkt und benötigen keinen API-Schlüssel.

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'

Antwortformat

{
  "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-Statuscodes

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": "..." }

Ratenbegrenzung

Häufig gestellte Fragen

Benötige ich einen API-Schlüssel?

Nein. Die Minecraft Profil-API ist kostenlos und erfordert keinen Schlüssel.

Was ist die Basis-URL?

Verwende https://vrc.lol als Basis-URL mit /minecraft-api, /head, /skin und /cape.

Kann ich per UUID statt Benutzername suchen?

Ubergib die UUID im Parameter username, zum Beispiel /minecraft-api?username=853c80ef3e3740fdaa867b06307a3d4f.

UUID-Format — mit oder ohne Bindestriche?

UUIDs werden sowohl ohne als auch mit Bindestrichen akzeptiert.

Anwendungsfälle

Discord

/minecraft-api | /head

CORS + JSON

fetch() | application/json

UUID + XUID

permissions.json | cache

Nächste Schritte

VRC.LOL · Discord

Unserem Discord beitreten

Stelle Fragen, teile Feedback und lerne die VRC.LOL-Community kennen.

Unserem Discord beitreten