Aktualisierungen

Neue Funktionen, Verbesserungen und Fehlerbehebungen für MCAPI.TR.

Letzte Aktualisierung:

Neue Funktion

Serververlauf und Beobachtungsberichte

Profile zeigen jetzt Beobachtungen für 24 Stunden, 7 und 30 Tage.

  • Spielergraphen, Höchstwerte, abgedeckte Intervalle und Zustandswechsel nutzen gespeicherte Snapshots ohne neue Minecraft-Abfragen.
  • Intervalle ohne Daten bleiben leer. Der Online-Beobachtungsanteil ist keine zeitbasierte Uptime.
  • GET /api/v1/history/{address} unterstützt period und bedrock.
Neue Funktion

Schrittweise Verbindungsdiagnose

Neues Werkzeug für DNS, SRV, Netzwerk und Minecraft-Statusprotokoll.

  • Java, Bedrock und Legacy werden nur auf Anfrage geprüft.
  • Private Ziele sind gesperrt; Zeitüberschreitungen bleiben uneindeutig. Ergebnisse werden zwischengespeichert und parallele Prüfungen begrenzt.
  • Keine Prüfung von Spieleranmeldung, Whitelist oder Authentifizierung. Auch über GET /api/v1/diagnostics/{address} verfügbar.
Neue Funktion

Integrationsbeispiele für 20 Umgebungen

Beispiele für Websites, Bots, CMS, Serversprachen, Minecraft-Plugins und Kommandozeile.

  • HTML/JavaScript, TypeScript, Next.js, React, Vue, Svelte, Python, PHP, WordPress, Java, C#, Go, Rust, NestJS, Discord.js, discord.py, Telegram, Paper/Spigot, Bash und PowerShell.
  • Mit Suche, Kategorien, anpassbarer Serveradresse, Kopieren, Dateidownload, Voraussetzungen und offizieller Dokumentation.
Neue Funktion

Der Serverkatalog bleibt automatisch aktuell

Die Erkennung und Prüfung von Servern hängt nicht mehr von Nutzerabfragen ab.

  • Externe Minecraft-Serverlisten werden seitenweise ausgelesen. Adressen werden erst nach einer gültigen Minecraft-Protokollantwort gespeichert.
  • Alle gespeicherten Server werden regelmäßig geprüft. Angestrebt werden 5 Minuten für erreichbare und 15 Minuten für nicht erreichbare Server; bei hoher Last werden Aufträge weiter in der Warteschlange verarbeitet.
  • Ergebnisse aktualisieren den Redis-Cache. Bei vorübergehenden Verbindungsfehlern bleiben die letzten erfolgreichen Daten erhalten; wiederholte Fehler bestätigen den Offline-Zustand.
  • Auch alte Adressen ohne auflösbaren DNS-Eintrag durchlaufen jetzt die Offline- und Cache-Verarbeitung.
Verbesserung

Mehr aktuelle Server in den Trends

Entdeckte Server können anhand beobachteter Daten erscheinen, bevor Nutzer sie abfragen.

  • Beobachtete Spielerzahlen fließen zusätzlich zu Nutzerinteresse und Erreichbarkeit in den Trendwert ein.
  • Die Werte werden beim Start und alle 15 Minuten neu berechnet.
  • Automatische Prüfungen zählen nicht als Nutzerabfragen und erhöhen weder das tägliche Wachstum noch die Liste letzter Nutzerabfragen künstlich.
Verbesserung

Serverprofile für Suchmaschinen vorbereitet

Serverinformationen stehen bereits in der ersten HTML-Antwort bereit.

  • Aktuelle, erreichbare Server mit hohem Trendwert werden in vier Sprachen in die dynamische Sitemap aufgenommen.
  • Kanonische URLs und Indexierungsanweisungen wurden ergänzt. Profile mit niedrigen Werten oder ohne aktuelle Online-Daten werden nicht zur Indexierung freigegeben.
  • Die Änderungen erleichtern das Crawling; Aufnahme und Platzierung in Suchergebnissen entscheiden die Suchmaschinen.
Neue Funktion

Seitennavigation für Serverkatalog und Trends

Datensätze können über mehrere Seiten statt nur einer Antwort abgerufen werden.

  • GET /api/v1/servers liefert gespeicherte Server mit Status online oder stale, ohne eine neue Netzwerkprüfung auszulösen.
  • Der Katalog und GET /api/v1/trends unterstützen page. meta.nextPage nennt die nächste Seite und ist am Ende null.
  • Der Katalog erlaubt bis zu 100 Einträge pro Seite, die Trends bis zu 50. Cursor bleiben verfügbar; page und cursor dürfen nicht gemeinsam verwendet werden.
  • Ein aktueller letzter Offline-Snapshot schließt den Server aus der öffentlichen Liste aus. Fehlende oder mehr als 24 Stunden alte Snapshots werden als stale gemeldet.
Neue Funktion

50 Server mit einer Anfrage prüfen

POST /api/v1/status/bulk wurde für Sammelabfragen ergänzt.

  • Pro Anfrage können bis zu 50 Server mit individuellen Java-, Bedrock- oder Legacy-Optionen übergeben werden.
  • Ergebnisse behalten die Eingabereihenfolge. Ein nicht erreichbarer Server verhindert die übrigen Ergebnisse nicht.
  • Wiederholte Prüfungen desselben Ziels verwenden ein gemeinsames Ergebnis; parallele Netzwerkprüfungen sind begrenzt.
Fehlerbehebung

Tägliches Wachstum und Trendseiten korrigiert

Die Wachstumsberechnung vergleicht jetzt zwei vollständige Zeiträume.

  • daily_growth vergleicht Nutzerabfragen der letzten vollständigen 24 Stunden mit den vorherigen 24 Stunden. Die laufende Stunde bleibt unberücksichtigt; ohne Vergleichswert wird 0 geliefert.
  • Die Trendberechnung läuft auch beim Start, ohne nach einem Neustart auf das erste Intervall zu warten.
  • Die Eignung eines Servers wird vor der Seiteneinteilung geprüft. So entstehen durch nachträgliches Filtern keine verkürzten Seiten oder widersprüchlichen Metadaten.