Güncellemeler

MCAPI.TR’ye eklenen özellikler, iyileştirmeler ve düzeltilen sorunlar.

Son güncelleme:

Yeni özellik

Sunucu geçmişi ve gözlem raporları

Sunucu profillerine 24 saat, 7 gün ve 30 günlük gözlem geçmişi eklendi.

  • Oyuncu grafiği, gözlemlenen zirve, veri bulunan aralıklar ve durum değişimleri kayıtlı snapshot’lardan hesaplanıyor. Geçmiş isteği yeni Minecraft kontrolü başlatmıyor.
  • Verisiz aralıklar boş bırakılıyor. Açık gözlem oranı zaman bazlı uptime olarak sunulmuyor.
  • Yeni GET /api/v1/history/{address} uç noktası period ve bedrock seçeneklerini destekliyor.
Yeni özellik

Adım adım bağlantı tanılama

DNS, SRV, ağ bağlantısı ve Minecraft protokol yanıtını inceleyen araç eklendi.

  • Java, Bedrock ve Legacy durum protokolleri destekleniyor. Kontrol yalnızca kullanıcı başlattığında çalışıyor.
  • Özel ağ hedefleri engelleniyor; zaman aşımı kesin kesinti olarak yorumlanmıyor. Sonuçlar önbelleğe alınıyor ve eşzamanlı kontroller sınırlandırılıyor.
  • Araç oyuncu girişi, whitelist veya hesap doğrulama testi yapmıyor. GET /api/v1/diagnostics/{address} üzerinden de kullanılabiliyor.
Yeni özellik

20 ortam için entegrasyon örnekleri

Web, bot, CMS, sunucu dili, Minecraft eklentisi ve komut satırı örnekleri bir araya getirildi.

  • HTML/JavaScript, TypeScript, Next.js, React, Vue, Svelte, Python, PHP, WordPress, Java, C#, Go, Rust, NestJS, Discord.js, discord.py, Telegram, Paper/Spigot, Bash ve PowerShell örnekleri eklendi.
  • Örnekler aranabiliyor, kategorilere göre filtrelenebiliyor, sunucu adresine uyarlanabiliyor, kopyalanabiliyor ve dosya olarak indirilebiliyor. Gereksinimler ve resmî dokümantasyon bağlantıları bulunuyor.
Yeni özellik

Sunucu kataloğu artık kendini güncelliyor

Sunucuların bulunması ve güncel tutulması için kullanıcı sorgusu beklemiyoruz.

  • Harici Minecraft sunucu listelerinden sayfa sayfa adres keşfi eklendi. Adresler, geçerli bir Minecraft protokol yanıtı alındıktan sonra kataloğa kaydediliyor.
  • Kayıtlı tüm sunucular düzenli kontrol sırasına alınıyor. Açık sunucular için 5 dakika, kapalı sunucular için 15 dakika kontrol aralığı hedefleniyor; yoğunlukta işler kuyrukta devam ediyor.
  • Kontrol sonuçları Redis önbelleğine yazılıyor. Geçici bağlantı sorunlarında son başarılı veri korunuyor; tekrarlanan başarısızlıklar kapalı durumu doğruluyor.
  • DNS kaydı artık çözülmeyen eski adresler de kapalı sonuç ve önbellek akışına dahil edildi.
İyileştirme

Trendlerde daha geniş ve güncel bir sunucu seçkisi

Keşfedilen sunucular, kullanıcılar henüz sorgulamamış olsa da gözlemlenen verileriyle sıralamaya katılabiliyor.

  • Gözlemlenen oyuncu sayısı trend puanına eklendi. Kullanıcı ilgisi ve erişilebilirlik sinyalleri kullanılmaya devam ediyor.
  • Trend puanları servis açılışında ve 15 dakikada bir yeniden hesaplanıyor.
  • Otomatik kontroller kullanıcı sorgusu sayılmıyor; günlük büyüme yüzdesini veya son kullanıcı sorguları listesini yapay olarak artırmıyor.
İyileştirme

Sunucu profilleri arama motorları için hazırlandı

Sunucu bilgileri artık sayfanın ilk HTML yanıtında da yer alıyor.

  • Yüksek trend puanlı, güncel ve açık sunucular dinamik site haritasına dört dilde ekleniyor.
  • Sunucu sayfalarına canonical adresleri ve uygun indeksleme yönergeleri eklendi. Düşük puanlı veya güncel açık verisi bulunmayan profiller indekslemeye açılmıyor.
  • Bu düzenlemeler sayfaların taranmasını kolaylaştırıyor; arama sonuçlarına eklenme ve sıralama arama motorlarının kararına bağlı.
Yeni özellik

Sunucu listesi ve trendlerde sayfalama

Kayıtları tek bir yanıtla sınırlı kalmadan sayfa sayfa alabilirsiniz.

  • GET /api/v1/servers uç noktası, daha önce kaydedilmiş online veya stale sunucuları listeliyor. Liste isteği yeni bir ağ kontrolü başlatmıyor.
  • Sunucu listesine ve GET /api/v1/trends uç noktasına page parametresi eklendi. meta.nextPage sonraki sayfayı, son sayfada ise null değerini veriyor.
  • Sunucu listesinde sayfa başına en fazla 100, trendlerde en fazla 50 kayıt alınabiliyor. Mevcut cursor desteği korunuyor; page ve cursor aynı istekte kullanılamıyor.
  • Son snapshot’ı güncel ve kapalı olan sunucular genel listeden çıkarılıyor. Snapshot’ı 24 saatten eski veya eksik olan kayıtlar stale olarak gösteriliyor.
Yeni özellik

Tek istekte 50 sunucu kontrolü

Çoklu sunucu kontrolü için POST /api/v1/status/bulk uç noktası eklendi.

  • Bir istekte en fazla 50 sunucu gönderilebiliyor. Java, Bedrock ve Legacy seçenekleri sunucu bazında belirtilebiliyor.
  • Sonuçlar gönderilen sırada dönüyor. Tek bir sunucunun kapalı olması veya hata vermesi diğer sonuçları engellemiyor.
  • Aynı hedefe ait tekrarlanan kontroller ortak sonucu kullanıyor; eşzamanlı ağ kontrolleri sınırlandırılıyor.
Düzeltme

Günlük büyüme hesabı ve trend sayfaları düzeltildi

Büyüme oranı artık karşılaştırılabilir iki tam döneme dayanıyor.

  • daily_growth, tamamlanmış son 24 saatin kullanıcı sorgularını önceki 24 saatle karşılaştırıyor. İçinde bulunulan eksik saat hesaba katılmıyor; önceki dönemde sorgu yoksa 0 dönüyor.
  • Trend hesabı servis açılışında da çalışıyor. Yeniden başlatma sonrasında ilk zamanlanmış hesaplamayı beklemek gerekmiyor.
  • Sunucunun listeye uygunluğu sayfalamadan önce kontrol ediliyor. Böylece eleme sonrasında eksik sayfa ve tutarsız sonraki sayfa bilgisi oluşması önleniyor.