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, açık kaynak MineVoteOdul 2.0 eklentisi bu API'yi kullanır. Spigot, Paper ve Purpur'da
1.13 – 1.21 arası çalışır (Java 8+). Oyuncu MineVote'ta oy verir, oyunda /vote yazar ve
ödülünü alır; aynı oy iki kez ödüllendirilmez. Menü, günlük seri (kombo) ödülleri, oy partisi, piñata,
şanslı ödüller ve Bedrock desteği içerir; tüm mesajlar config.yml'den değiştirilir.
Neden daha güvenli? Sunucunuza dışarıdan istek gönderilmez; sunucunuz bizim API'mize sorar. Açık port olmadığı için dışarıya açık bir kapı kalmaz ve sahte oy paketiyle ödül alınamaz; ödül kaydı MineVote veritabanında tutulur. Votifier'a göre birkaç saniye yavaştır, ama en güvenli yöntem budur.
- MineVoteOdul.jar dosyasını indirip sunucunuzun
pluginsklasörüne atın. (Açık kaynak kodu, MIT lisans) 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.
Oy akışı (sayaç ve oy partisi için)
Kendi sitenizde oy sayacı veya oy partisi göstermek için son oyları okuyabilirsiniz. Bu uçlar salt okunurdur, anahtar Sunucu Düzenle sayfasındaki anahtarla aynıdır ve biçim Minecraft-MP ile uyumludur. Yanıtlar JSON'dur; IP ve cihaz bilgisi dönmez.
GET https://minevote.com.tr/api/?object=servers&element=votes&key={anahtar}&format=json&limit=100- Son oylar, en yeniden eskiye (
limiten fazla 500). Her oy:id,date,timestamp,nickname,claimed,ranked.ranked0 ise oy sıralamaya sayılmamıştır. GET https://minevote.com.tr/api/?object=servers&element=voters&key={anahtar}&month=current&format=json- Oyuncu başına oy sayısı.
month:currentveyaprevious. GET https://minevote.com.tr/api/?object=servers&element=detail&key={anahtar}- Sunucu özeti: bu ayki oy (
votes) ve toplam oy (total_votes).
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.