Démarrage rapide

API de Profils Minecraft

Obtenez UUID, skin, cape et historique des noms pour tout joueur Minecraft. Une URL, réponse JSON. Sans inscription.

Minecraft API

Envoyer votre premiere requete de profil

Envoyez une requete GET HTTPS avec un pseudo ou gamertag. Demandez Java, Bedrock ou les deux, puis verifiez l'objet present avant ses identifiants et ressources.

GET https://vrc.lol/minecraft-api?username=Notch&type=all
Accept: application/json
JSONJava + BedrockEtat du cacheAucune cle API

GET + HTTPS

Tous les endpoints

Utilisez le point de terminaison de profil pour les données JSON et les points de ressources pour des fichiers PNG prêts à afficher.

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

Options de requete

Indiquez explicitement l’identifiant et l’édition lorsque votre application exige des résultats prévisibles.

username

name | gamertag | UUID | XUID

type

all | java | bedrock

suggest

search text + limit 1-100

update

true · 3600s profile cooldown

Exemples de code

Ces requêtes utilisent le point de terminaison Minecraft et ne nécessitent aucune clé 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'

Format de réponse

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

Codes d’état 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": "..." }

Limites de requêtes

Questions fréquentes

L'API nécessite-t-elle une clé ?

Non. L'API de Profils Minecraft est gratuite et ne nécessite aucune clé.

Quelle est l'URL de base ?

Utilisez https://vrc.lol comme URL de base avec /minecraft-api, /head, /skin et /cape.

Puis-je chercher par UUID au lieu du nom ?

Transmettez l'UUID dans le parametre username, par exemple /minecraft-api?username=853c80ef3e3740fdaa867b06307a3d4f.

Format UUID — avec ou sans tirets ?

Les UUID bruts et avec tirets sont acceptes.

Cas d’utilisation

Discord

/minecraft-api | /head

CORS + JSON

fetch() | application/json

UUID + XUID

permissions.json | cache

Étapes suivantes

VRC.LOL · Discord

Rejoignez notre Discord

Demandez de l’aide, partagez vos avis et rencontrez la communauté VRC.LOL.

Rejoignez notre Discord