Editing Zh:Mojang API

== 注意 ==

* 所有公共API均受速率限制，因此您应该缓存这些结果。当前的设置为每10分钟600个请求，但可能会更改。
* 对于API的某些部分，有时包括演示版帐户但有时又不包括。Mojang一直在改动它。

== API状态 ==

  GET https://status.mojang.com/check

返回各类Mojang服务的状态。可能的值为<code>green</code>（无问题）、<code>yellow</code>（有些许问题）、<code>red</code>（服务不可用）。

=== 响应 ===

<syntaxhighlight lang="javascript" style="overflow-x: scroll">
[
  {
    "minecraft.net": "yellow"
  },
  {
    "session.minecraft.net": "green"
  },
  {
    "account.mojang.com": "green"
  },
  {
    "auth.mojang.com": "green"
  },
  {
    "skins.minecraft.net": "green"
  },
  {
    "authserver.mojang.com": "green"
  },
  {
    "sessionserver.mojang.com": "yellow"
  },
  {
    "api.mojang.com": "green"
  },
  {
    "textures.minecraft.net": "red"
  },
  {
    "mojang.com": "green"
  }
]
</syntaxhighlight>

== 用户名 -> 在某时间的UUID ==

  GET <nowiki>https://api.mojang.com/users/profiles/minecraft/<username>?at=<timestamp></nowiki>

这将返回在提供的时间戳时该用户名的UUID。

<code>?at=0</code>可用于获取该名称原始用户的UUID，但是这只有在名称至少更改一次或帐户是旧帐户的情况下才有效。

* 时间戳是指[[wikipedia:zh:Unix时间|UNIX时间戳]]（不包含毫秒）
* 当未发送<code>at</code>参数时，将使用当前时间

=== 响应 ===

<syntaxhighlight lang="javascript" style="overflow-x: scroll">
{
  "id": "7125ba8b1c864508b92bb5c042ccfe2b",
  "name": "KrisJelbring"
}
</syntaxhighlight>

* <code>name</code>是'''该uuid的当前名称'''，而并不是'''请求的名称'''！
* <code>legacy</code>仅在为true时显示（未迁移到mojangd的帐户）
* <code>demo</code>仅在为true（未付款的帐户）时显示

如果不存在使用给定用户名的玩家，则会发送不带任何HTTP正文的HTTP状态代码<code>204 (No Content)</code>。<br/>
如果时间戳不是数字、太大或太小都会发送HTTP状态代码<code>400 (Bad Request)</code>，并显示如下错误消息：

<syntaxhighlight lang="javascript" style="overflow-x: scroll">
{
  "error": "IllegalArgumentException",
  "errorMessage": "Invalid timestamp."
}
</syntaxhighlight>

== UUID -> 名称历史 ==

  <nowiki>GET https://api.mojang.com/user/profiles/<uuid>/names</nowiki>

返回该用户之前使用过的所有用户名和当前使用的用户名。UUID必须不带连字符。


=== 响应 ===

<syntaxhighlight lang="javascript" style="overflow-x: scroll">
[
  {
    "name": "Gold"
  },
  {
    "name": "Diamond",
    "changedToAt": 1414059749000
  }
]
</syntaxhighlight>

<code>changedToAt</code>字段是Java时间戳（以毫秒为单位）。

== 玩家名 -> UUIDs ==

  POST <nowiki>https://api.mojang.com/profiles/minecraft</nowiki>

=== 负载 ===

<syntaxhighlight lang="javascript" style="overflow-x: scroll">
[
    "maksimkurb",
    "nonExistingPlayer" //测试不存在的玩家
]
</syntaxhighlight>

=== 响应 ===

<syntaxhighlight lang="javascript" style="overflow-x: scroll">
[
    {
        "id": "0d252b7218b648bfb86c2ae476954d32",
        "name": "maksimkurb",
        "legacy": true,
        "demo": true
    }
]
</syntaxhighlight>

* 名称区分大小写
* 旧版仅在为true时显示（档案未迁移到mojang.com）
* 演示版仅在为true时显示（帐户未付款）
* 如果任何用户名为null或空，则返回IllegalArgumentException
* <code>Content-Type</code>HTTP头必须为<code>application/json</code>
* 每个请求不能超过10个名字

== UUID -> 档案 + 皮肤/披风 ==

  <nowiki>GET https://sessionserver.mojang.com/session/minecraft/profile/<uuid></nowiki>

这将返回玩家的用户名以及它们相关的所有其他信息（如皮肤）。示例https://sessionserver.mojang.com/session/minecraft/profile/4566e69fc90748ee8d71d7ba5aa00d20

这有一个更严格的速率限制：你只可以每分钟请求一次相同的档案，但是您可以发送任意多的唯一请求。

[[Category:ZH:Protocol Details]]
[[Category:ZH:Minecraft Modern]]

=== 响应 ===
<syntaxhighlight lang="javascript" style="overflow-x: scroll">
{
    "id": "<profile identifier>",
    "name": "<player name>",
    "properties": [ 
        {
            "name": "textures",
            "value": "<base64 string>",
            "signature": "<base64 string; signed data using Yggdrasil's private key>" //仅在url后接?unsigned=false时提供
        }
    ]
}
</syntaxhighlight>

* 如果用户尚未将minecraft.net帐户迁移到mojang，则<code>"legacy": true</code>将出现在响应中。
"textures"对象"value"的base64解码后字符串：
<syntaxhighlight lang="javascript" style="overflow-x: scroll">
{
    "timestamp": <java time in ms>,
    "profileId": "<profile uuid>",
    "profileName": "<player name>",
    "signatureRequired": true, // 仅在url后接?unsigned=false时提供
    "textures": {
        "SKIN": {
            "url": "<player skin URL>"
        },
        "CAPE": {
            "url": "<player cape URL>"
        }
    }
}
</syntaxhighlight>

* 时间戳有时会是过去的（可能是由于缓存了结果？）
* 若玩家模型拥有纤细的手臂（“Alex”样式），则<code>"SKIN"</code>对象将拥有<code>"metadata": {"model": "slim"}</code>。而对于方形手臂（“Steve”样式），则将缺少<code>"metadata"</code>。
* 如果未设置自定义皮肤，则将缺少<code>"SKIN"</code>。<br>玩家是否具有“Alex?”或“Steve?”外观，取决于其UUID的[http://hg.openjdk.java.net/jdk8/jdk8/jdk/file/687fd7c7986d/src/share/classes/java/util/UUID.java#l394 Java哈希码]。奇哈希则将使用Steve。示例实现：
** [https://github.com/mapcrafter/mapcrafter-playermarkers/blob/c583dd9157a041a3c9ec5c68244f73b8d01ac37a/playermarkers/player.php#L8-L19 PHP]
** [https://github.com/LapisBlue/Lapitar/blob/55ede80ce4ebb5ecc2b968164afb40f61b4cc509/mc/uuid.go#L34-L36 Go]
** [https://github.com/crafatar/crafatar/blob/9d2fe0c45424de3ebc8e0b10f9446e7d5c3738b2/lib/skins.js#L90-L108 JavaScript]（包含注释）
** [https://web.archive.org/web/20151022205119/https://gist.github.com/jomo/9968b8d572c38e1b1f4c Java]（包含示例UUID）
* 相似地，当帐号没有披风时将缺少<code>"CAPE"</code>。

== 更换皮肤 ==
 POST <nowiki>https://api.mojang.com/user/profile/</nowiki>'''<uuid>'''/skin

这将为所选档案设置皮肤，但Mojang的服务器将从URL获取皮肤。这也适用于旧版帐户。

=== 响应 ===
发生错误时，服务器将发送回带有错误的JSON。（若成功为空白有效负载）

=== 头 ===
 Authorization: Bearer '''<access token>'''

=== 负载 ===
此API的有效负载由两个url编码的表单字段（由'＆'组成）组成。
 model='''<""/"slim">'''&url='''<skin url>'''

model是默认模型的空字符串，而slim模型为“slim”。

=== 示例 ===
 curl -H "Authorization: Bearer '''<access token>'''" --data-urlencode "model=" --data-urlencode "url=<nowiki>http://assets.mojang.com/SkinTemplates/steve.png</nowiki>" <nowiki>https://api.mojang.com/user/profile/</nowiki>'''<uuid>'''/skin

 POST /user/profile/'''<uuid>'''/skin HTTP/1.1
 Host: api.mojang.com
 User-Agent: curl/7.49.0
 Accept: */*
 Authorization: Bearer '''<access token>'''
 Content-Length: 69
 Content-Type: application/x-www-form-urlencoded
 
 model=&url=http%3A%2F%2Fassets.mojang.com%2FSkinTemplates%2Fsteve.png

== 上传皮肤 ==
 PUT <nowiki>https://api.mojang.com/user/profile/</nowiki>'''<uuid>'''/skin

这会将皮肤上传到Mojang的服务器，同时设置了用户的皮肤。这也适用于旧版帐号。

=== 响应 ===
除非错误，否则无响应

=== 头 ===
 Authorization: Bearer '''<access token>'''

=== 负载 ===
该API的负载由多部分表单数据组成。有两部分（顺序与边界的b/c无关）：

{| class="wikitable"
|'''model'''
|默认模型为空字符串，纤细模型为"slim"
|-
|'''file'''
|原始图像文件数据
|}

=== 示例 ===
 curl -X PUT -H "Authorization: Bearer '''<access token>'''" -F model=alex -F file="@alex.png;type=image/png" <nowiki>https://api.mojang.com/user/profile/</nowiki>'''<uuid>'''/skin

 PUT /user/profile/'''<uuid>'''/skin HTTP/1.1
 Host: api.mojang.com
 User-Agent: curl/7.49.0
 Accept: */*
 Authorization: Bearer '''<access token>'''
 Content-Length: '''<length>'''
 Content-Type: multipart/form-data; boundary='''<boundary>'''
 
 --'''<boundary>'''
 Content-Disposition: form-data; name="model"
 
 slim
 --'''<boundary>'''
 Content-Disposition: form-data; name="file"; filename="alex.png"
 Content-Type: image/png
 
 '''<image data>'''
 --'''<boundary>'''--

== 重置皮肤 ==
 DELETE <nowiki>https://api.mojang.com/user/profile/</nowiki>'''<uuid>'''/skin

将用户的皮肤重置为默认皮肤。

=== 响应 ===
除非错误，否则无响应

=== 头 ===
 Authorization: Bearer '''<access token>'''

=== 示例 ===
 curl -X DELETE -H "Authorization: Bearer '''<access token>'''" <nowiki>https://api.mojang.com/user/profile/</nowiki>'''<uuid>'''/skin

 DELETE /user/profile/'''<uuid>'''/skin HTTP/1.1
 Host: api.mojang.com
 User-Agent: curl/7.46.0
 Accept: */*
 Authorization: Bearer '''<access token>'''

== 被阻止的服务器 ==
   GET https://sessionserver.mojang.com/blockedservers

返回用于在客户端尝试连接时对照服务器地址进行检查的SHA1哈希列表。

客户端使用ISO-8859-1字符集依据此列表检查小写名称。他们还将尝试检查子域名，并用<code>*</code>替换每个级别。具体来说，它会根据域名中的<code>.</code>进行拆分，遍历每个部分，一次删除一个。例如，对于<code>mc.example.com</code>，它将尝试<code>mc.example.com</code>、<code>*.example.com</code>和<code>*.com</code>。使用IP地址（通过划分为4个部分进行验证，每个部分都是0到255之间的有效整数，包括0和255之间的有效整数<!-- 反编译结果显示似乎用空的if将其弄乱了，但是有检查范围的逻辑 -->），替换将从头开始，因此对于<code>192.168.0.1</code>，它将尝试<code>192.168.0.1</code>、<code>192.168.0.*</code>、<code>192.168.*</code>和<code>192.*</code>。

此检查由netty中的bootstrap类完成。默认netty类被启动器加载的com.mojang:netty依赖覆盖。这使其可以影响使用netty（1.7+）的任何版本。

=== 响应 ===
所有按行分隔的SHA1哈希列表。

目前约有2200种哈希值已被破解。
<pre>
6f2520f8bd70a718c568ab5274c56bdbbfc14ef4:*.minetime.com
7ea72de5f8e70a2ac45f1aa17d43f0ca3cddeedd:*.trollingbrandon.club
c005ad34245a8f2105658da2d6d6e8545ef0f0de:*.skygod.us
c645d6c6430db3069abd291ec13afebdb320714b:*.mineaqua.es
8bf58811e6ebca16a01b842ff0c012db1171d7d6:*.eulablows.host
8789800277882d1989d384e7941b6ad3dadab430:*.moredotsmoredots.xyz
e40c3456fb05687b8eeb17213a47b263d566f179:*.brandonlovescock.bid
278b24ffff7f9f46cf71212a4c0948d07fb3bc35:*.brandonlovescock.club
c78697e385bfa58d6bd2a013f543cdfbdc297c4f:*.mineaqua.net
b13009db1e2fbe05465716f67c8d58b9c0503520:*.endercraft.com
3e560742576af9413fca72e70f75d7ddc9416020:*.insanefactions.org
986204c70d368d50ffead9031e86f2b9e70bb6d0:*.playmc.mx
65ca8860fa8141da805106c0389de9d7c17e39bf:*.howdoiblacklistsrv.host
7dca807cc9484b1eed109c003831faf189b6c8bf:*.brandonlovescock.online
c6a2203285fb0a475c1cd6ff72527209cc0ccc6e:*.brandonlovescock.press
e3985eb936d66c9b07aa72c15358f92965b1194e:*.insanenetwork.org
b140bec2347bfbe6dcae44aa876b9ba5fe66505b:*.phoenixnexus.net
27ae74becc8cd701b19f25d347faa71084f69acd:*.arkhamnetwork.org
48f04e89d20b15de115503f22fedfe2cb2d1ab12:brandonisan.unusualperson.com
9f0f30820cebb01f6c81f0fdafefa0142660d688:*.kidslovemy500dollarranks.club
cc90e7b39112a48064f430d3a08bbd78a226d670:*.eccgamers.com
88f155cf583c930ffed0e3e69ebc3a186ea8cbb7:*.fucktheeula.com
605e6296b8dba9f0e4b8e43269fe5d053b5f4f1b:*.mojangendorsesbrazzers.webcam
5d2e23d164a43fbfc4e6093074567f39b504ab51:touchmybody.redirectme.net
f3df314d1f816a8c2185cd7d4bcd73bbcffc4ed8:*.mojangsentamonkeyinto.space
073ca448ef3d311218d7bd32d6307243ce22e7d0:*.diacraft.org
33839f4006d6044a3a6675c593fada6a690bb64d:*.diacraft.de
e2e12f3b7b85eab81c0ee5d2e9e188df583fe281:*.eulablacklist.club
11a2c115510bfa6cb56bbd18a7259a4420498fd5:*.slaughterhousepvp.com
75df09492c6c979e2db41116100093bb791b8433:*.timelesspvp.net
d42339c120bc10a393a0b1d2c6a2e0ed4dbdd61b:*.herowars.org
4a1b3b860ba0b441fa722bbcba97a614f6af9bb8:justgiveinandblockddnsbitches.ddns.net
b8c876f599dcf5162911bba2d543ccbd23d18ae5:brandonisagainst.health-carereform.com
9a9ae8e9d0b6f3bf54c266dcd1e4ec034e13f714:brandonwatchesporn.onthewifi.com
336e718ffbc705e76b4a72884172c6b95216b57c:canyouwildcardipsplease.gotdns.ch
27cf97ecf24c92f1fe5c84c5ff654728c3ee37dd:letsplaysome.servecounterstrike.com
32066aa0c7dc9b097eed5b00c5629ad03f250a2d:mojangbrokeintomy.homesecuritymac.com
39f4bbfd123a5a5ddbf97489877831c15a70d7f2:*.primemc.org
f32f824d41aaed334aef248fbe3a0f8ecf4ac1a0:*.meep.in
c22efe4cf7fb319ca2387bbc930c1fdf77ab72fc:*.itsjerryandharry.com
cc8e1ae93571d144bf4b37369cb8466093d6db5a:*.thearchon.net
9c0806e5ffaccb45121e57e4ce88c7bc76e057f1:*.goatpvp.com
5ca81746337088b7617c851a1376e4f00d921d9e:*.gotpvp.com
a5944b9707fdb2cc95ed4ef188cf5f3151ac0525:*.guildcraft.org
</pre>

== 统计信息 ==
  POST <nowiki>https://api.mojang.com/orders/statistics</nowiki>

获取有关Minecraft销量的统计信息。

=== 负载===
负载是"metricKeys"键下的json选项列表。
您将收到与所请求类型的销售总额相对应的单个对象。
您必须请求至少一种销售类型。
以下是https://minecraft.net/en/stats/使用的默认列表
<syntaxhighlight lang="javascript" style="overflow-x: scroll">
{
    "metricKeys": [
        "item_sold_minecraft",
        "prepaid_card_redeemed_minecraft"
    ]
}
</syntaxhighlight>

有效选项有：
    item_sold_minecraft
    prepaid_card_redeemed_minecraft
    item_sold_cobalt
    item_sold_scrolls

=== 响应 ===
返回一个包含已销售副本总数、最近24小时内售出的副本数量和每秒的销售量的json对象。
<syntaxhighlight lang="javascript" style="overflow-x: scroll">
{
    "total": integer total amount sold,
    "last24h": integer total sold in last 24 hours,
    "saleVelocityPerSeconds": decimal average sales per second
}
</syntaxhighlight>

== 示例 ==

[https://github.com/hawezo/MojangSharp C#] | 完整的API包装器

[https://github.com/PhilipBorgesen/minecraft/tree/master/profile Go] | UUID或名称至拥有皮肤、披风和名称历史的档案

[https://github.com/SynchronousX/mojang-api Python] | 完整的API包装器

[https://github.com/techkid6/AccountsClientPython Python] | UUID或名称至档案

[https://gist.github.com/jomo/74944770e7647855ac9d Python] | 名称的文件至UUID和名称的文件

[https://github.com/MineTheCube/MojangAPI PHP] | UUID或名称至拥有皮肤、头颅和名称历史的档案

[https://gist.github.com/ezfe/a71feccd3a837a2592f1 PHP] | UUID至名称

[https://github.com/ozzyfant/AccountsClientPHP PHP] | UUID至名称、名称至UUID

[https://github.com/SparklingComet/java-mojang-api Java] | 几近完整的API包装器

[https://github.com/thechunknetwork/mojang-api JavaScript] | UUID或名称至拥有皮肤、披风和名称历史的档案

[[Category:ZH:Protocol Details]]
[[Category:ZH:Minecraft Modern]]