条目中某些信息已经不符合当前版本情况。
Mojang API是Mojang提供的“应用程序编程接口”,允许用户使用自编程序检索玩家数据,它适用于第三方启动器开发人员、服务器运营商和插件开发人员。
所有查询目前限制为每10分钟600次[1]。对于没有购买游戏的注册帐户,也可以进行部分信息的查询。
某个时刻的UUID
- 输入示例
玩家的名称(不区分大小写)和可选的UNIX时间(1970年1月1日以来的秒数)。 如果省略UNIX时间,则假定当前时间。
- GET查询
https://api.mojang.com/users/profiles/minecraft/<Spielername>
或https://api.mojang.com/users/profiles/minecraft/<Spielername>?at=<UNIX-Zeit>
- 输出
- 根标签
- id:玩家的UUID。
- name:玩家姓名用正确的大写/小写字母。
- legacy:true 如果它是一个旧的Minecraft帐户。否则,输出中不包括legacy。
- demo:true 如果是非付费演示帐户,则输出中不包括“demo”。
- 示例
https://api.mojang.com/users/profiles/minecraft/OYO123?at=1420066800
提供玩家的UUID“oyo 123”截至2015年1月1日。输出在一行中,没有空格和换行符,仅在此处显示结构化:
{ "id":"61699b2ed3274a910f1e0ea8c3f06bc6", "name":"oyo123" }
- 错误信息
- 如果没有命名的玩家,则不会传送任何输出(HTTP Status Code 204 = no content)。
- 如果UNIX时间不是有效值,则返回HTTP状态代码400(= bad request),并显示以下错误消息:
{"error":"IllegalArgumentException","errorMessage":"Invalid timestamp."}
所有玩家的名字
- 输入示例
玩家的UUID。
- GET查询
https://api.mojang.com/user/profiles/<UUID>/names
- 输出
- 此帐户曾经拥有的所有玩家名称的列表。 注意:这些不是第二个帐户,但都更改了帐户的玩家名称。
- 玩家名称。
- name:正确大小写的玩家名称。
- changedToAt:更改UNIX时间(1970年1月1日以来的秒数)的时间。
- 玩家名称。
- 示例
https://api.mojang.com/user/profiles/61699b2ed3274a910f1e0ea8c3f06bc6/names
返回原始玩家名称oyo 123,从2015年2月4日到'xXoyoXx'的变化以及从2015年4月1日到'__oyo__'的变化。输出在一行中,没有空格和换行符,仅在此处显示结构化:
[ { "name": "oyo123" }, { "name": "xXoyoXx", "changedToAt": 1423047600000 }, { "name": "__oyo__", "changedToAt": 1427882400000 } ]
- 错误信息
- 如果没有具有UUID的玩家,则不会传送任何输出 (HTTP Status Code 204 = no content)。
所有UUID
- 输入示例
最多100个玩家名称的列表。 “Content-Type”HTTP标头必须是“application/json”。
- GET查询
https://api.mojang.com/profiles/minecraft
- 输出
- 给定玩家的所有UUID列表。 对于不存在的玩家名称,将不返回任何结果。
- 玩家名称。
- id:玩家的UUID。
- name:正确大小写的玩家名称。
- legacy:true 如果它是一个旧的Minecraft帐户。否则,输出中不包括legacy。
- demo:true 如果是非付费演示帐户,则输出中不包括“demo”。
- 玩家名称。
- 示例
发送["oyo123","yoyo"]
. 输出在一行中,没有空格和换行符,仅在此处显示结构化:
[ { "id": "61699b2ed3274a910f1e0ea8c3f06bc6", "name": "oyo123" }, { "id": "06cb8cae14793ec50df31026ac5f420a", "name": "yoyo", "legacy": true, "demo": true } ]
- 错误信息
- 如果集合中缺少玩家名称(连续两个逗号)或空字符串"",则返回IllegalArgumentException。
皮肤和披风
- 输入示例
玩家的UUID以及签名的请求。 可以在一分钟后最早重复对给定UUID的查询。
- GET查询
https://sessionserver.mojang.com/session/minecraft/profile/<UUID>
或https://sessionserver.mojang.com/session/minecraft/profile/<UUID>?unsigned=false
- 输出
- 根标签
- id:玩家的UUID。
- name:正确大写的玩家名称。
- properties:玩家属性的列表。
- name:玩家属性的名称。到目前为止只有“材质”(“玩家材质”)这一属性。
- signature:只有在请求时,Mojang服务器“Yggdrasil”的私钥才会作为Base64字符串传递。
- value:Base64字符串Base64中包含的所有材质(皮肤和披风)。可以将Base64字符串在线解码,例如使用这个网站。解密后,您将获得以下信息:
- 示例
https://sessionserver.mojang.com/session/minecraft/profile/61699b2ed3274a910f1e0ea8c3f06bc6
输出在一行中,没有空格和换行符,仅在此处显示结构化:
{ "id":"61699b2ed3274a910f1e0ea8c3f06bc6", "name":"oyo123", "properties": [ { "name":"stringures", "value":"eyJ0aW1lc3RhbXA..." } ] }
- 错误信息
- 如果没有具有UUID的玩家,则不会传送任何输出(HTTP Status Code 204 = no content)。
历史
- Mojang API于2014年4月14日发布。[2]