Quelltext der Seite Mojang API

{{Diese Seite|die Webschnittstelle von Mojang|die Programmierschnittstelle des Spiels|Plugin API}}
Die '''Mojang API''' (''Application Programming Interface'') ist eine von [[Mojang]] zur Verfügung gestellte Programmierschnittstelle, über die man mit selbst geschriebenen Programmen Spielerdaten abfragen kann. Sie ist für Serverbetreiber und Plugin-Entwickler gedacht und wird durch einen [[Client-Server-Konzept#Mojang-Server|Mojang-Server]] betrieben.

Alle Abfragen sind zur Zeit auf 600 pro 10 Minuten begrenzt<ref>http://wiki.vg/Mojang_API</ref>. Manche Abfragen sind auch für Demo-[[Account]]s (registrierte Accounts ohne Kauf des Spiels) möglich, aber nicht alle.

== UUID zu bestimmter Zeit ==

{| class="wikitable" style="width:100%; margin-top:0; margin-bottom:0;" 
! style="width:110px" | Eingabe
| Ein Spielername (Groß-/Kleinschreibung ist egal) und optional eine UNIX-Zeit (Sekunden seit dem 1. Januar 1970). Wird die UNIX-Zeit weggelassen, wird die aktuelle Zeit angenommen. [http://www.unixtime.de/ Hier] gibt es eine Online-Umrechnung der UNIX-Zeit.
|-
! GET-Abfrage
| <code><nowiki>https://api.mojang.com/users/profiles/minecraft/</nowiki><''Spielername''></code> oder<br><code><nowiki>https://api.mojang.com/users/profiles/minecraft/</nowiki><''Spielername''>?at=<''UNIX-Zeit''></code>
|}
{| class="wikitable" style="float:left; margin-top:0; margin-bottom:0;" 
! style="width:110px;height:100px;vertical-align:middle" | Ausgabe
|}
<div class="treeview">
* {{JSON|objekt}}
** {{JSON|text|id:}} Die [[UUID]] des Spielers.
** {{JSON|text|name:}} Der Spielername in korrekter Groß-/Kleinschrift. 
** {{JSON|bool|legacy:}} ''true'', wenn es sich um einen [[Account#Alter Minecraft-Account|alten Minecraft-Account]] handelt, ansonsten ist ''legacy'' nicht in der Ausgabe enthalten.
** {{JSON|bool|demo:}} ''true'', wenn es sich um einen nicht bezahlten Demo-Account handelt, ansonsten ist ''demo'' nicht in der Ausgabe enthalten.
</div>
{| class="wikitable" style="width:100%; margin-top:0; margin-bottom:0;" 
! style="width:110px" | Beispiel
| <code><nowiki>https://api.mojang.com/users/profiles/minecraft/OYO123?at=1420066800</nowiki></code><br>liefert die UUID des Spielers "[[Minecraft Wiki:oyo123|oyo123]]" zum 1. Januar 2015. Die Ausgabe erfolgt in einer Zeile ohne Leerzeichen und Zeilenumbrüche und wird nur hier strukturiert dargestellt:
<pre>
 {
   "id":"61699b2ed3274a910f1e0ea8c3f06bc6",
   "name":"oyo123"
 }</pre>
|-
! Fehlermeldungen
| 
* Wenn es keinen Spieler mit dem Namen gibt, wird keine Ausgabe geliefert (HTTP Status Code 204 = no content).
* Wenn die UNIX-Zeit kein gültiger Wert ist, wird der HTTP Status Code 400 (= bad request) mit folgender Fehlermeldung geliefert:<br><code>{"error":"IllegalArgumentException","errorMessage":"Invalid timestamp."}</code>
|}

== Alle Spielernamen ==

{| class="wikitable" style="width:100%; margin-top:0; margin-bottom:0;" 
! style="width:110px" | Eingabe
| Die UUID eines Spielers.
|-
! GET-Abfrage
| <code><nowiki>https://api.mojang.com/user/profiles/</nowiki><''UUID''>/names</code>
|}
{| class="wikitable" style="float:left; margin-top:0; margin-bottom:0;" 
! style="width:110px;height:80px;vertical-align:middle" | Ausgabe
|}
<div class="treeview">
* {{JSON|liste}} Eine Liste mit allen Spielernamen, die dieser Account jemals hatte. Achtung: Das sind nicht die Zweitaccounts, sondern alle geänderten Spielernamen eines Accounts.
** {{JSON|objekt}} Ein Spielername.
*** {{JSON|text|name:}} Der Spielername in korrekter Groß-/Kleinschrift. 
*** {{JSON|zahl|changedToAt:}} Änderungszeitpunkt in UNIX-Zeit (Sekunden seit dem 1. Januar 1970).
</div>
{| class="wikitable" style="width:100%; margin-top:0; margin-bottom:0;" 
! style="width:110px" | Beispiel
| <code><nowiki>https://api.mojang.com/user/profiles/61699b2ed3274a910f1e0ea8c3f06bc6/names</nowiki></code><br>liefert den ursprünglichen Spielernamen ''[[Minecraft Wiki:oyo123|oyo123]]'', die Änderung vom 4. Februar 2015 in ''xXoyoXx'' und die Änderung vom 1. April 2015 in ''__oyo__''. Die Ausgabe erfolgt in einer Zeile ohne Leerzeichen und Zeilenumbrüche und wird nur hier strukturiert dargestellt:
<pre>
 [
   {
     "name": "oyo123"
   },
   {
     "name": "xXoyoXx",
     "changedToAt": 1423047600000
   },
   {
     "name": "__oyo__",
     "changedToAt": 1427882400000
   }
 ]</pre>
|-
! Fehlermeldungen
| 
* Wenn es keinen Spieler mit der UUID gibt, wird keine Ausgabe geliefert (HTTP Status Code 204 = no content).
|}

== Alle UUIDs ==

{| class="wikitable" style="width:100%; margin-top:0; margin-bottom:0;" 
! style="width:110px" | Eingabe
| Eine Liste von maximal 10 Spielernamen. Der "Content-Type"-HTTP header muss "application/json" sein.
|-
! POST-Abfrage an
| <code><nowiki>https://api.mojang.com/profiles/minecraft</nowiki></code>
|}
{| class="wikitable" style="float:left; margin-top:0; margin-bottom:0;" 
! style="width:110px;height:120px;vertical-align:middle" | Ausgabe
|}
<div class="treeview">
* {{JSON|liste}} Eine Liste mit allen UUIDs der übergebenen Spieler. Für nicht existierende Spielernamen wird kein Ergebnis geliefert.
** {{JSON|objekt}} Ein Spielername.
*** {{JSON|text|id:}} Die [[UUID]] des Spielers.
*** {{JSON|text|name:}} Der Spielername in korrekter Groß-/Kleinschrift. 
*** {{JSON|bool|legacy:}} ''true'', wenn es sich um einen [[Account#Alter Minecraft-Account|alten Minecraft-Account]] handelt, ansonsten ist ''legacy'' nicht in der Ausgabe enthalten.
*** {{JSON|bool|demo:}} ''true'', wenn es sich um einen nicht bezahlten Demo-Account handelt, ansonsten ist ''demo'' nicht in der Ausgabe enthalten.
</div>
{| class="wikitable" style="width:100%; margin-top:0; margin-bottom:0;" 
! style="width:110px" | Beispiel
| Senden von <code><nowiki>["oyo123","yoyo"]</nowiki></code>. Die Ausgabe erfolgt in einer Zeile ohne Leerzeichen und Zeilenumbrüche und wird nur hier strukturiert dargestellt:
<pre>
 [
   {
     "id": "61699b2ed3274a910f1e0ea8c3f06bc6",
     "name": "oyo123"
   },
   {
     "id": "06cb8cae14793ec50df31026ac5f420a",
     "name": "yoyo",
     "legacy": true,
     "demo": true
   }
 ]</pre>
|-
! Fehlermeldungen
| 
* Wenn ein Spielername in der Auflistung fehlt (zwei Kommas hintereinander) oder ein Leerstring "" ist, wird eine IllegalArgumentException geliefert.
|}

== Skin und Cape ==

{| class="wikitable" style="width:100%; margin-top:0; margin-bottom:0;" 
! style="width:110px" | Eingabe
| Die UUID eines Spielers und optional die Anforderung einer [[de.wikipedia:Digitale Signatur|Signatur]]. Die Abfrage für eine bestimmte UUID kann frühestens nach einer Minute wiederholt werden.
|-
! GET-Abfrage
| <code><nowiki>https://sessionserver.mojang.com/session/minecraft/profile/</nowiki><''UUID''></code> oder<br><code><nowiki>https://sessionserver.mojang.com/session/minecraft/profile/</nowiki><''UUID''>?unsigned=false</code>
|}
{| class="wikitable" style="float:left; margin-top:0; margin-bottom:0;" 
! style="width:110px;height:470px;vertical-align:middle" | Ausgabe
|}
<div class="treeview">
* {{JSON|objekt}}
** {{JSON|text|id:}} Die [[UUID]] des Spielers.
** {{JSON|text|name:}} Der Spielername in korrekter Groß-/Kleinschrift. 
** {{JSON|liste|properties:}} Eine Liste der Eigenschaften des Spielers.
*** {{JSON|text|name:}} Name der Eigenschaft. Es gibt bisher nur die Eigenschaft "textures" ("Spielertexturen").
*** {{JSON|text|signature:}} Nur wenn angefordert, wird hier der private Schlüssel des Mojang-Servers "Yggdrasil" als Base64-String geliefert.
*** {{JSON|text|value:}} Alle Texturen (Skin und ggf. Cape) in einer [[de.wikipedia:Base64|Base64]]-Zeichenkette. Für Base64 gibt es Online-Decodierungen, z.B. [https://www.base64decode.org/ diese]. Nach der Entschlüsselung erhält man folgende Informationen:
**** {{JSON|objekt}} Das namenlose Texturobjekt.
***** {{JSON|text|profileId}}: Optional die [[UUID]] des Spielers ohne Bindestriche.
***** {{JSON|text|profileName}}: Optional der Spielername.
***** {{JSON|boolean|isPublic}}: ''true'' oder ''false''. Der Wert ''true'' ist Standard und kann weggelassen werden. ''false'' gibt an, dass die Textur-URL nicht öffentlich zugänglich ist.
***** {{JSON|objekt|textures:}} Die Texturen.
****** {{JSON|objekt|SKIN:}} [[Skin]]-Textur.
******* {{JSON|text|url:}} Die URL der Skin-Textur.
******* {{JSON|objekt|metadata:}} Optional. Metadaten zum Skin.
******** {{JSON|text|model:}} "slim", wenn das Spielermodell "Alex" ist. Beim Spielermodell "Steve" fehlen die Metadaten.
****** {{JSON|objekt|CAPE:}} [[Umhang]]-Textur.
******* {{JSON|text|url:}} Die URL der Umhang-Textur. Ein Umhang wird bei Köpfen nicht angezeigt. Ansonsten wird ein Umhang nur angezeigt, wenn in den Account-Daten des Spielers ein Umhang durch Mojang eingetragen wurde.
***** {{JSON|zahl|timestamp:}} Optional die [[de.wikipedia:Unixzeit|Unixzeit]] in Millisekunden des Zeitpunktes, wann die Texturdaten abgerufen wurden. Die Umrechnung von Unix-Sekunden in Realzeit ist z. B. [https://www.unixtime.de/ hier] möglich, man muss aber vorher die letzten drei Stellen vom ''timestamp'' entfernen, da es Millisekunden sind.
</div>
{| class="wikitable" style="width:100%; margin-top:0; margin-bottom:0;" 
! style="width:110px" | Beispiel
| <code><nowiki>https://sessionserver.mojang.com/session/minecraft/profile/61699b2ed3274a910f1e0ea8c3f06bc6</nowiki></code><br>Die Ausgabe erfolgt in einer Zeile ohne Leerzeichen und Zeilenumbrüche und wird nur hier strukturiert dargestellt:
<pre>
 {
   "id":"61699b2ed3274a910f1e0ea8c3f06bc6",
   "name":"oyo123",
   "properties":
   [
     {
       "name":"textures",
       "value":"eyJ0aW1lc3RhbXA..."
     }
   ]
 }</pre>
|-
! Fehlermeldungen
| 
* Wenn es keinen Spieler mit der UUID gibt, wird keine Ausgabe geliefert (HTTP Status Code 204 = no content).
|}

== Geschichte ==
{{Geschichtlich
|title = custom
|customTitle = Geschichte
|group1 = 14. April 2014
|list1 = *Die Mojang API wurde veröffentlicht<ref>https://github.com/Mojang/AccountsClient</ref>.
}}

== Einzelnachweise ==
{{Verweisliste}}

{{Navbox-Minecraftdaten}}

[[zh:Mojang API]]