Ana içeriğe atla Discord'a katıl

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.

  1. MineVoteOdul.jar dosyasını indirip sunucunuzun plugins klasörüne atın. (Açık kaynak kodu, MIT lisans)
  2. plugins/MineVoteOdul/config.yml içindeki api-key satırına, Sunucu Düzenle sayfasındaki anahtarı yapıştırın.
  3. /minevote reload ve /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.

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 (limit en fazla 500). Her oy: id, date, timestamp, nickname, claimed, ranked. ranked 0 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: current veya previous.
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.

İlgili sayfalar

Reklam Reklam

Ortaklık

İş Ortaklarımız

Bizimle beraber çalışan bazı şirketler