mojang-redis

README

📨 mojang-redis 📨

A Go microservice for the Mojang API, to serve responses faster and create REDIS caches for each request.

FROM 444ms

TO 1ms

🐳 Quick start with Docker

git clone https://github.com/net32/mojang-redis.git
docker-compose up -d

📝 API Reference

Request are the same of Mojang API

📌 Username to UUID

GET /users/profiles/minecraft/${userName}
GET /users/profiles/minecraft/notch

Parameter	Type	Description
userName	string	Required. Username of player to fetch

Response

{
	"name": "Notch",
	"id": "069a79f444e94726a5befca90e38aaf5"
}

📌 Usernames to UUIDs

POST /profiles/minecraft

Parameter	Type	Description
body	json	Required. Json payload of userNames to fetch

Body payload

[
    "NeT32",
    "notch",
    "nonExistingPlayer"
]

Response

[
	{
		"id": "c5870df744e9495f928a0e3e8703a03e",
		"name": "net32"
	},
	{
		"id": "069a79f444e94726a5befca90e38aaf5",
		"name": "Notch"
	}
]

📌 UUID to Name History

GET /user/profiles/${uuid}/names
GET /user/profiles/14f19f5050cb44cd9f0bbe906ad59753/names

Parameter	Type	Description
uuid	string	Required. UUID of player to fetch

Response

[
	{
		"name": "HaloIsBae"
	},
	{
		"name": "BilboBeaver",
		"changedToAt": 1450912796000
	},
	{
		"name": "Bar",
		"changedToAt": 1495337426000
	}
]

📌 UUID to Profile and Skin/Cape

GET /session/minecraft/profile/${uuid}?unsigned=false
GET /session/minecraft/profile/069a79f444e94726a5befca90e38aaf5?unsigned=true

Parameter	Type	Description
uuid	string	Required. UUID of player to fetch
unsigned	boolean	Optional. If need signature use false

Response

{
	"id": "069a79f444e94726a5befca90e38aaf5",
	"name": "Notch",
	"properties": [
		{
			"name": "textures",
			"value": "ewogICJ0aW1lc3RhbXAiIDogMTY0OTgxMjMzNzk2NywKICAicHJvZmlsZUlkIiA6ICIwNjlhNzlmNDQ0ZTk0NzI2YTViZWZjYTkwZTM4YWFmNSIsCiAgInByb2ZpbGVOYW1lIiA6ICJOb3RjaCIsCiAgInRleHR1cmVzIiA6IHsKICAgICJTS0lOIiA6IHsKICAgICAgInVybCIgOiAiaHR0cDovL3RleHR1cmVzLm1pbmVjcmFmdC5uZXQvdGV4dHVyZS8yOTIwMDlhNDkyNWI1OGYwMmM3N2RhZGMzZWNlZjA3ZWE0Yzc0NzJmNjRlMGZkYzMyY2U1NTIyNDg5MzYyNjgwIgogICAgfQogIH0KfQ=="
		}
	]
}

📌 Blocked Servers

GET /blockedservers

Response

A line-separated list of all SHA1 hashes.

d7aaeee640a82d97b182d237c46e6fe4c6d55fe3
fc14b4c345af53bd3a8566de92b71186432253cc
c5c03d9bad5c5ad25deb64600b9cd900312d4d74
72fd29f430c91c583bb7216fe673191dc25a7e18