Beschreibung der API-Statistiken
- 11.12.2017
Mit unserer API können Sie Daten erhalten, auf dem Server oder einen Spieler im JSON-Format für seine Plug-In, Anwendungen oder Website.
Anfrage GET, POST
https://minecraft-statistic.net/api/server/add/?ip=SERVER_IP&port=SERVER_PORT
SERVER_IP - IP-Serveradresse SERVER_PORT - Server-Port Beispiel: https://minecraft-statistic.net/api/server/add/?ip=127.0.0.1&port=12365
JSON-Antwort
[false,"IP address is entered not correctly or is local network"]
[0] - true - Server hinzugefügt, false - Fehler beim Hinzufügen [1] - Server-ID oder Fehlerbeschreibung
Anfrage GET
https://minecraft-statistic.net/api/server/info/ID
Der letzte Parameter kann einer von drei Typen sein: ID - eindeutige Server-ID IP_PORT - IP-Adresse und Server-Port URI - eindeutige Server-URL Ein Beispiel für eine Abfrage an einen einzelnen Server mit unterschiedlichen Parametern: https://minecraft-statistic.net/api/server/info/91.200.47.122_25565 https://minecraft-statistic.net/api/server/info/51 https://minecraft-statistic.net/api/server/info/supersky
JSON-Antwort
{
/*(int) Server-ID*/
"_id": 51,
/*(string) die eindeutige Adresse des Servers in der Überwachung (falls vorhanden, kann der Serveradministrator die IP-Adresse und den Port des Servers ändern)*/
"uri": "supersky",
/*(object) Online-Spieler-Diagramm für 24 Stunden, mit einem Intervall von 10 Minuten*/
"chart": {
/*(string) Zeit im HH:ii Format und die Anzahl der Online Spieler (int)*/
"00:00": 13,
/* . . . */
"23:50": 13
},
/*(object) Serverzähler*/
"counter": {
/*(int) Anzahl der Kommentare (Rezensionen)*/
"cmts": 4,
/*(int) Likes, die Anzahl der Personen, die den Server zu Ihren Favoriten hinzugefügt haben*/
"favorite": 4,
/*(int) Zähler offline, die Anzahl der Male der Server offline war, da die Zugabe von*/
"offline": 16077,
/*(int) Online-Zähler, wie oft der Server seit dem Hinzufügen online war*/
"online": 74564,
/*(object) die Gesamtzahl der Spieler, die seit dem Hinzufügen auf dem Server gespielt haben*/
"players": {
/*(string) Datum im Format YYYY-mm-dd, wenn Spieler gezählt werden (der Zähler wird einmal pro Tag gezählt und zeigt immer Daten für gestern an)*/
"date": "2015-06-23",
/*(int) Anzahl der Spieler, die auf dem Server gespielt haben*/
"total": 27482
},
/*(int) Anzahl der Screenshots hinzugefügt*/
"screenshot": 6
},
/*(int) Datum des Hinzufügens des Servers zur Überwachung im Unix-Timestamp-Format*/
"date_add": 1379283352,
/*(string) Serverdomäne*/
"domain": "mc.supersky.org.ua",
/*(string) Link zum Herunterladen des Launcher*/
"download_url": "",
/*(object) Server-Geodaten*/
"geo": {
/*(string) Serverstadt*/
"city": "Sevastopol",
/*(string) Serverland im Format ISO 3166 A2*/
"country": "UA",
/*(string) Serverland*/
"country_name": "\u0423\u043a\u0440\u0430\u0438\u043d\u0430"
},
/*(object) grundlegende Informationen über den Server*/
"info": {
/*(string) der Name des Servers wird beim Polling aktualisiert (in den Servereinstellungen ist dies die Variable motd)*/
"name": "SuperSky Survival 1.7.x-1.8.x",
/*(string) Art des Serverspiels*/
"type": "SMP",
/*(string) Server-Plattform, mögliche Werte von "MINECRAFT" oder "MINECRAFTPE"*/
"platform": "MINECRAFT",
/*(string) Serverversion*/
"version": "1.8",
/*(array) Liste der Plugins, die auf dem Server installiert sind*/
"plugins": ["WorldEdit 6.0.2-SNAPSHOT,3347-fe6717a0", " HealthBar 1.8.2", " PvPTime 0.1.22", " Essentials TeamCity", " LogBlock 1.81", " ClearLag 2.7.7", " AutoMessage 2.5.2", " FullBright 1.1", " MonsterFix 0.4.3", " ProtocolLib 3.6.3-SNAPSHOT", " WorldGuard 6.0.0-SNAPSHOT.1550-", " NoCheatPlus 3.12.1-SNAPSHOT-sMD5NET-b823", " SkinsRestorer 9.3", " HeadDrops 2.0", " PermissionsEx 1.23.3", " RandomPort 2.0", " ColoredTablist 1.1.0", " Vault 1.5.0-b28", " HideStream 3.7", " ProtocolSupport 4.13", " EssentialsSpawn TeamCity", " SalvageSmelter 0.1.8", " CustomEnchantments 2.2a", " Autorank 3.5.1-Dev-382", " AuthMe 3.4", " ScoreboardStats 0.9.1", " GlobalMarket 1.2.2", " ChatEx 1.2", " ChatGuard 6.3"],
/*(int) Anzahl der Spieler online*/
"players": 16,
/*(int) maximale Anzahl an Spielern (Slots)*/
"max_players": 30,
/*(array) Liste der Spieler online*/
"players_list": ["Shamandra", "vlad_3881", "ATmega8", "Koshmarik", "Gohjay", "vipit", "msx9086", "Creeper1903", "__Pig131__", "baklajan", "marines", "uaruk", "dasides", "thelinx", "KORVELION", "saf_alex_100"],
/*(string) Server-Kartenname*/
"map": "world",
/*(string) Serversoftware*/
"software": "CraftBukkit on Bukkit 1.8-R0.1-SNAPSHOT",
/*(float) Durchschnittliche Anzahl der Spieler für 24 Stunden*/
"avg_player_day": 14.83,
/*(float) сdurchschnittliche Serverlast für 24 Stunden*/
"avg_load_day": 49.42
},
/*(string) IP-Serveradresse (v4)*/
"ip": "91.200.47.122",
/*(object) Datum der letzten Online / Offline*/
"last": {
/*(int) Das Datum des letzten Offline im Unix-Timestamp-Format*/
"offline": 1434915770,
/*(int) Das Datum des letzten Online im Unix-Timestamp-Format*/
"online": 1435056332
},
/*(int) Datum der Datenaktualisierung im Unix-Format Timestamp*/
"last_update": 1435056332,
/*(string) Link zur Serverkarte*/
"map_url": "",
/*(object) Serverdatensätze*/
"max_stat": {
/*(object) maximal online*/
"max_online": {
/*(int) Datum des Online-Maximums im Unix-Timestamp-Format, wenn der Datensatz wiederholt wird (derselbe Wert) oder ein neuer Datensatz gesetzt wird, wird das Datum aktualisiert*/
"date": 1434882170,
/*(int) Anzahl der Spieler online*/
"players": 30
}
},
/*(int) Server-Port*/
"port": 25565,
/*(object) Bewertungsdaten*/
"rating": {
/*(float) Der Content-Anteil, wie viel Prozent der gezählten Wertung der Server zusätzlich erhält, dafür dass er eine Beschreibung, Screenshots usw. hinzugefügt hat.*/
"K": 12.23,
/*(float) Inhaltsbonus*/
"content_up": 0.77,
/*(float) die Bewertungsdifferenz zum vorherigen Wert (um wie viel sich die Bewertung in 10 Minuten geändert hat)*/
"difference": 0.73,
/*(float) aktueller Serverrang*/
"main": 7.73
},
/*(int) Abfragestatus 1 - Überwachung aktiviert, 0 - Überwachung deaktiviert (der Server trennt die Überwachung automatisch, wenn die Betriebszeit unter 5% liegt)*/
"scan": 1,
/*(int) Serverstatus 1 - online, 0 - offline*/
"status": 1,
/*(string) Server-Verfügbarkeit als Prozentsatz (das Verhältnis der Anzahl der Gespräche zu einem offline)*/
"uptime": "82.26",
/*(string) or (array) Liste der Serverreferenzen, die vom Administrator über das Bedienfeld hinzugefügt und auf der Serverseite angezeigt werden*/
"url": [],
/*(string) Antwort API "ok" - der Server existiert und alles ist in Ordnung*/
"status_query": "ok"
}
Anfrage GET
https://minecraft-statistic.net/api/server/top/SERVER_ID/PERIOD/PAGE
SERVER_ID - Server-ID PERIOD - Zeitraum, für den Sie die Bewertung der Spieler erhalten möchten, gibt es drei Möglichkeiten: all - Bewertung der Spieler für alle Zeiten today - Bewertung der Spieler für heute yesterday - Bewertung der Spieler für gestern PAGE - Seite Beispiel: https://minecraft-statistic.net/api/server/top/51/all/1 - Top-Spieler für alle Zeit auf dem Server ID=51 https://minecraft-statistic.net/api/server/top/51/today/1 - Top-Spieler für heute auf dem Server ID=51 https://minecraft-statistic.net/api/server/top/51/yesterday/1 - Top-Spieler für gestern auf dem Server ID=51
JSON-Antwort
https://minecraft-statistic.net/api/server/top/51/all/1
{
/*(string) Antwortstatus (ok) oder Fehler (error)*/
"status_query": "ok",
/*(int) Server-ID*/
"server_id": 51,
/*(int) Seitennummer*/
"page": 1,
/*(array) Bewertungsdaten*/
"data": [{
/*(string) Nickname des Spielers*/
"nickname": "Alejandro",
/*(int) Platz in der Rangliste*/
"place": 1,
/*(int) Zeit online, in Minuten*/
"time": 91290,
/*(int) der Zeitpunkt des letzten Serverbesuchs*/
"last_visit": 1511113315
}, {
"nickname": "zeikyn",
"place": 2,
"time": 78550,
"last_visit": 1506805303
}, {
"nickname": "pokeshmon",
"place": 3,
"time": 75950,
"last_visit": 1478622539
}, {
"nickname": "BOYARIN",
"place": 4,
"time": 62760,
"last_visit": 1501956577
}, {
"nickname": "NikZ",
"place": 5,
"time": 62690,
"last_visit": 1506886904
}, {
"nickname": "thelinx",
"place": 6,
"time": 60730,
"last_visit": 1510314159
}, {
"nickname": "Mexoc",
"place": 7,
"time": 58180,
"last_visit": 1512924339
}, {
"nickname": "keco185",
"place": 8,
"time": 58120,
"last_visit": 1504279213
}, {
"nickname": "Bobillho",
"place": 9,
"time": 57280,
"last_visit": 1502314183
}, {
"nickname": "karnaj",
"place": 10,
"time": 55700,
"last_visit": 1506850904
}, {
"nickname": "Kosatka",
"place": 11,
"time": 54010,
"last_visit": 1511707572
}, {
"nickname": "nikolskiy24",
"place": 12,
"time": 52390,
"last_visit": 1509547946
}, {
"nickname": "Faer_Killer",
"place": 13,
"time": 49660,
"last_visit": 1509394343
}, {
"nickname": "A_n_t_o_n",
"place": 14,
"time": 47340,
"last_visit": 1512903339
}, {
"nickname": "Epik",
"place": 15,
"time": 47310,
"last_visit": 1506763902
}, {
"nickname": "pavel555",
"place": 16,
"time": 47280,
"last_visit": 1490586905
}, {
"nickname": "ottoblotto",
"place": 17,
"time": 45270,
"last_visit": 1465206230
}, {
"nickname": "None",
"place": 18,
"time": 44200,
"last_visit": 1511715973
}, {
"nickname": "mix55",
"place": 19,
"time": 43560,
"last_visit": 1499848744
}, {
"nickname": "opa225",
"place": 20,
"time": 43010,
"last_visit": 1479235151
}, {
"nickname": "Vovanchik",
"place": 21,
"time": 41170,
"last_visit": 1512726935
}, {
"nickname": "ender007HD",
"place": 22,
"time": 40960,
"last_visit": 1510997572
}, {
"nickname": "akkaunt",
"place": 23,
"time": 39780,
"last_visit": 1502355584
}, {
"nickname": "OXOTHIK_UA",
"place": 24,
"time": 39190,
"last_visit": 1512902139
}, {
"nickname": "lololowhka21",
"place": 25,
"time": 39050,
"last_visit": 1497876515
}, {
"nickname": "Giperfox",
"place": 26,
"time": 38010,
"last_visit": 1506462062
}, {
"nickname": "uikk",
"place": 27,
"time": 36900,
"last_visit": 1509709948
}, {
"nickname": "mad78",
"place": 28,
"time": 36850,
"last_visit": 1498768128
}, {
"nickname": "Right",
"place": 29,
"time": 36840,
"last_visit": 1511638571
}, {
"nickname": "lololowhka",
"place": 30,
"time": 36390,
"last_visit": 1478455133
}]
}
Anfrage GET
https://minecraft-statistic.net/api/player/info/PLAYER_NAME/SERVER_ID
PLAYER_NAME - Spielername (erforderlich) SERVER_ID - Server-ID (optional, geben Sie an, ob Sie Spielerstatistiken auf diesem Server abrufen möchten) Beispiel: https://minecraft-statistic.net/api/player/info/djoice - Statistiken für den Spieler djoice https://minecraft-statistic.net/api/player/info/djoice/51 - djoice Spielerstatistiken auf dem Server mit ID=51
JSON-Antwort
https://minecraft-statistic.net/api/player/info/djoice/
{
/*(string) der Antwortstatus ist ok oder error (wenn Fehler, dann gibt es anstelle des Datenfeldes ein msg Feld mit einer Beschreibung des Fehlers)*/
"status": "ok",
/*(object) Daten*/
"data": {
/*(int) Die Zeit des letzten Online im Unixtime-Format*/
"last_play": 1435936128,
/*(int) Das Konto ist lizenziert oder nicht (es funktioniert immer noch nicht genau, es wird nicht empfohlen, es für die Überprüfung zu verwenden)*/
"license": 1,
/*(int) Spielerstatus 1 - online, 0 - offline*/
"online": 0,
/*(int) Gesamtzeit online, in Minuten*/
"total_time_play": 15625,
/*(string) Nickname des Spielers*/
"name": "djoice",
/*(string) UUID des Spielers im Mojang-System*/
"uuid": "146db9a0bb494f24abed5749be50be29"
}
}
https://minecraft-statistic.net/api/player/info/djoice/51
{
"status": "ok",
"data": {
"last_play": 1435936128,
"license": 1,
"online": 0,
/*(int) Gesamtzeit online auf dem Server mit ID=51, in Minuten*/
"total_time_play": 3920,
"name": "djoice",
"uuid": "146db9a0bb494f24abed5749be50be29"
}
}