API Dokümantasyonu
MineVote, liste ve oy arayüzü için JSON uç noktaları sunar. Tüm yanıtlar application/json formatındadır.
Oy gönderimi için tarayıcı oturumu ve CSRF koruması gerekir; sunucu durumu uçları salt okunurdur.
Port'suz oy ödülü — Oy Talep (Vote Claim) API
Votifier'da site, oy gelince oyun sunucunuza bağlanır; bunun için açık bir port gerekir. Birçok oyun hostingi buna izin vermez. Oy Talep API'sinde ise tersi olur: sunucunuzdaki ödül eklentisi MineVote'a "bu oyuncu oy verdi mi?" diye sorar ve ödülü kendisi verir. Port açmanız gerekmez.
En kolay yol: MineVote Ödül eklentisi
Resmi MineVoteOdul eklentisi bu API'yi kullanır. Spigot, Paper ve Purpur'da,
1.8'den güncel sürümlere kadar çalışır (Java 8+). Oyuncu MineVote'ta oy verir,
oyunda /vote yazar ve ödülünü alır; aynı oy iki kez ödüllendirilmez.
- MineVoteOdul.jar dosyasını indirip sunucunuzun
pluginsklasörüne atın. plugins/MineVoteOdul/config.ymliçindekiapi-keysatırına, Sunucu Düzenle sayfasındaki anahtarı yapıştırın./minevote reloadve/minevote test OyuncuAdıile bağlantıyı doğrulayın.
Biçim, Minecraft-MP ve Minecraft Pocket Servers oy API'siyle birebir aynıdır. API adresi değiştirilebilen eklentilerde adres olarak aşağıdakini, anahtar olarak da Sunucu Düzenle sayfasındaki size özel anahtarı yazmanız yeterli.
GET https://minevote.com.tr/api/?object=votes&element=claim&key={anahtar}&username={oyuncu}- Oy durumu (düz metin):
0= oy yok,1= oy var, ödül alınmamış,2= oy var, ödül alınmış. GET https://minevote.com.tr/api/?action=post&object=votes&element=claim&key={anahtar}&username={oyuncu}- Ödülü alındı olarak işaretler:
1= şimdi işaretlendi,2= zaten alınmış,0= oy yok.
- Oy, sunucunun oy bekleme süresi boyunca talep edilebilir (standart 24 saat).
- Yanıtlar her zaman HTTP 200 ve düz metindir; anahtar hatalıysa
Error: invalid server keydöner. - Paper, Spigot, Purpur ve diğer çatallarda çalışan, Minecraft-MP formatını destekleyen eklentilerle uyumludur.
- Votifier'ı da kullanıyorsanız ikisinden yalnızca birini ödül vermeye ayarlayın; aksi halde oyuncu aynı oy için iki kez ödül alır.
VoteMe hakkında: VoteMe port gerektirmeyen bir oy ödülü eklentisidir. Şu an yalnızca Minecraft-MP ve Minecraft Pocket Servers adreslerini tanıyor; eklentinin ayar dosyasından farklı bir site eklenemiyor. MineVote API'si aynı formatta olduğundan, eklentinin MineVote'u desteklemesi için geliştiricisinin yalnızca MineVote adresini eklemesi yeterli. Bu eklendiğinde ek bir ayar yapmadan çalışacaktır.
Sunucu bilgisi ve oy
GET https://minevote.com.tr/api_vote.php?id={sunucu_id}- Onaylı sunucunun adı, IP, oy sayısı, sıra ve logo bilgisini döner.
POST https://minevote.com.tr/api_vote.php- Oy gönderir (
server_id, CSRF token, rate limit). Başarılı yanıtta güncel oy sayısı yer alır.
Canlı sunucu durumu
GET https://minevote.com.tr/api_server_status.php?id={sunucu_id}- Tek sunucu için çevrimiçi durum ve oyuncu sayısı (önbellekli ping).
GET https://minevote.com.tr/api_server_status_batch.php?ids=1,2,3- En fazla 36 sunucu için toplu durum (virgülle ayrılmış ID listesi).
Platform
GET https://minevote.com.tr/api_platform_online_total.php- Listelenen sunuculardaki toplam çevrimiçi oyuncu tahmini:
{"total":123}. İsteğe bağlı?refresh=1.
