API Documentation

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-free vote rewards — Vote Claim API

With Votifier, the site connects to your game server when a vote arrives, which requires an open port. Many game hosts do not allow that. The Vote Claim API works the other way round: the reward plugin on your server asks MineVote "has this player voted?" and hands out the reward itself. No open port is needed.

The easiest way: the MineVote Reward plugin

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 plugins klasörüne atın. (Açık kaynak kodu, MIT lisans)
plugins/MineVoteOdul/config.yml içindeki api-key satırına, Edit Server sayfasındaki anahtarı yapıştırın.
/minevote reload ve /minevote test OyuncuAdı ile bağlantıyı doğrulayın.

The format is identical to the Minecraft-MP and Minecraft Pocket Servers vote API. In plugins that let you change the API URL, enter the address below as the URL and, as the key, the private key shown on your Edit Server page.

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.

A vote can be claimed during the server's vote cooldown (24 hours by default).
Yanıtlar her zaman HTTP 200 ve düz metindir; anahtar hatalıysa Error: invalid server key döner.
Compatible with plugins that support the Minecraft-MP format on Paper, Spigot, Purpur and other forks.
If you also use Votifier, configure only one of them to give rewards; otherwise players are rewarded twice for the same vote.

About VoteMe: VoteMe is a port-free vote reward plugin. It currently only knows the Minecraft-MP and Minecraft Pocket Servers addresses; another site cannot be added from its config file. Because the MineVote API uses the same format, the plugin's developer only needs to add the MineVote address for it to support MineVote. Once that is added it will work with no extra setup.

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 Edit Server 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).

Server info and votes

GET https://minevote.com.tr/api_vote.php?id={sunucu_id}: Returns an approved server's name, IP, vote count, rank and logo.
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.

Live server status

GET https://minevote.com.tr/api_server_status.php?id={sunucu_id}: Online status and player count for a single server (cached ping).
GET https://minevote.com.tr/api_server_status_batch.php?ids=1,2,3: Bulk status for up to 36 servers (comma-separated ID list).

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.