Pornire rapidă

API Profiluri Minecraft

Obține UUID, skin, capă și istoricul numelor oricărui jucător Minecraft. Un URL, răspuns JSON. Fără înregistrare.

Minecraft API

Trimite prima cerere de profil

Trimite un GET HTTPS cu nume sau gamertag. Solicita Java, Bedrock sau ambele si verifica obiectul prezent inainte de identificatori si resurse.

GET https://vrc.lol/minecraft-api?username=Notch&type=all
Accept: application/json
JSONJava + BedrockStarea cache-uluiFara cheie API

GET + HTTPS

Toate endpoint-urile

Folosește endpointul de profil pentru date JSON și endpointurile de resurse pentru fișiere PNG gata de afișare.

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

Optiuni pentru cerere

Specifică explicit identificatorul și ediția când aplicația are nevoie de rezultate previzibile.

username

name | gamertag | UUID | XUID

type

all | java | bedrock

suggest

search text + limit 1-100

update

true · 3600s profile cooldown

Exemple de cod

Aceste cereri folosesc endpointul Minecraft și nu necesită cheie 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'

Formatul răspunsului

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

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

Limite de solicitări

Întrebări frecvente

Este nevoie de cheie API?

Nu. API-ul de Profiluri Minecraft este gratuit și nu necesită cheie.

Care este URL-ul de bază?

Foloseste https://vrc.lol ca URL de baza impreuna cu /minecraft-api, /head, /skin si /cape.

Pot căuta după UUID?

Trimite UUID-ul in parametrul username, de exemplu /minecraft-api?username=853c80ef3e3740fdaa867b06307a3d4f.

Format UUID — cu sau fără cratime?

Sunt acceptate UUID-uri fara cratime si cu cratime.

Cazuri de utilizare

Discord

/minecraft-api | /head

CORS + JSON

fetch() | application/json

UUID + XUID

permissions.json | cache

Pașii următori

VRC.LOL · Discord

Intră pe Discordul nostru

Cere ajutor, oferă feedback și cunoaște comunitatea VRC.LOL.

Intră pe Discordul nostru