API - Let's Mine Minecraft Community

Schnittstelle zur Informationsabfrage

Die hier beschriebene API ist größtenteils REST konform.
Mehrsprachigkeit (XML, HTML, JSON, etc.) wird aktuell nicht unterstützt, alle Antworten werden als JSON zurückgegeben.
Weitere Informationen sind der entsprechenden Version zu entnehmen.

[tabmenu]

Version 1
Version 2
Version X

Übersicht
Banlist
players/position

Bei der Version 1 handelt es sich um eine persistente Alpha-Version. Sie stellt nur Lese-Operationen bereit und ist unter www.letsmine.eu/api/game/v1/ erreichbar.
Es sind keine URI oder POST Parameter für erweiterte, gefilterte oder sortierte Ausgaben möglich.
Diese Version wird nach dem Update auf Let's Mine 3.0 nicht mehr weitergeführt.

Zeigt alle aktuell gebannte User an.
Entbannte User werden gelöscht.
IP's werden normalerweise nicht angezeigt.
URI
www.letsmine.eu/api/game/v1/banlist/
Rückgabe
JSON Array
Element Aufbau

Name	Type	Beschreibung
ban	VARCHAR(36)	Name oder UUID des Gebannten (IP's sollten nicht erscheinen, sind aber auch möglich)
reason	VARCHAR(1000)	Grund des Banns
time_from	TIMESTAMP	Zeitpunkt des Banns
time_to	TIMESTAMP	Zeitpunkt des Entbanns oder NULL
uuid	CHAR(36)	UUID des Banners (0000... = Console)

Für die Übersichtskarte die Spieleranzeige.
Es werden die Spieler angezeigt, wo sie sich vor 30sec. befanden.
Nach einem Serverneustart werden die ersten 30sec. keine Updates des ersten Datensatzes geliefert. (war bei der ersten Aufnahme ein Spieler online, bleibt dieser für 30sec. an der selben Stelle)

URI
www.letsmine.eu/api/game/v1/players/position/
Rückgabe
JSON Array
Element aufbau

Name	Type	Beschreibung
msg	String	Name des Spielers
id	int	Für die Übersichtskarte - type 4 = Spieler
world	String	Name der Welt
x	int	Position X (Block Position)
y	int	Position Y (Block Position)
z	int	Position Z (Block Position)

Übersicht

Bei der Version 2 handelt es sich um eine nicht persistente Beta Version.
Bedeutet, dass sich das Rückgabe Format, der URI Aufbau und Header-Daten ändern können.

Planung
Login mit Ingame-Daten für Rang abhängige Informationen

Übersicht
weekly

Bei Version X handelt es sich um eine API, die nicht persistent ist, es können sich jeder Zeit "Dinge" ändern oder einfach wegfallen.

Wöchentliche Ausgaben
Jeden Sonntag um 0 Uhr werden die Statistiken erstellt und sind ab 0:30 Uhr Verfügbar.

Vote-Statistik der vergangenen Woche: /api/stats/weekly/weekly_vote_list.csv

Logblock-Statistiken der vergangenen Woche:
- Magea: /api/stats/weekly/weekly_logblock_magea_list.csv
- Asonas: /api/stats/weekly/weekly_logblock_asonas_list.csv
- Khados: /api/stats/weekly/weekly_logblock_khados_list.csv
- Varon: /api/stats/weekly/weekly_logblock_varon_list.csv
- JobFarm: /api/stats/weekly/weekly_logblock_jobfarm_list.csv

JobFarm verdienst (Top 10): /api/stats/weekly/weekly_money_jobfarm.csv

Warp-Statistiken der vergangenen Woche: /api/stats/weekly/weekly_logging_warp_list.csv

Teilen
Zitieren

Teilen