빠른 시작

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은 무엇인가요?

기본 URL은 https://vrc.lol이며 /minecraft-api, /head, /skin 및 /cape와 함께 사용합니다.

UUID로 검색할 수 있나요?

UUID를 username 매개변수로 전달합니다. 예: /minecraft-api?username=853c80ef3e3740fdaa867b06307a3d4f.

UUID 형식 — 하이픈 포함 또는 미포함?

하이픈이 없는 UUID와 하이픈이 있는 UUID를 모두 사용할 수 있습니다.

사용 사례

Discord

/minecraft-api | /head

CORS + JSON

fetch() | application/json

UUID + XUID

permissions.json | cache

다음 단계

VRC.LOL · Discord

Discord 커뮤니티 참여

도움을 요청하고 의견을 공유하며 VRC.LOL 커뮤니티를 만나세요.

Discord 커뮤니티 참여