BG
English Български Русский Español Português Türkçe Tiếng Việt 中文 한국어 ไทย Filipino Azərbaycan

За собственици на сървъри

Добави сървъра си, сложи линка за гласуване на сайта си и награждавай играчите автоматично. Три стъпки:

Избери играта си - страницата ще покаже точно какво трябва да настроиш за нея.

1. Линкът за гласуване

Сложи този линк на сайта си (SERVER_ID е в Моите сървъри):

https://mmotop100.com/vote/SERVER_ID?u=PLAYER_NAME

u = акаунтът на твоя играч (букви, цифри, _ . @ -, до 64). Връща се при теб в postback-а, за да знаеш кого да наградиш.

2. Как играчите ти получават наградата

Postback - казваме на сайта ти, че играчът е гласувал

След всеки преброен глас викаме твоя postback адрес (POST, полета на форма):

ПолеЗначение
server_idномерът на сървъра ти
vote_idномерът на гласа - уникален; награждавай всеки vote_id САМО ВЕДНЪЖ
useru от линка ти за гласуване
ipIP адресът на гласувалия
countryдържавата на гласувалия (две букви, може да е празно)
timeкога (unix секунди, UTC)
test1 = тест от панела ти, не награждавай
sigподпис: HMAC-SHA256 на "vote_id|server_id|user|ip|time" с тайния ти ключ

Сайтът ти чете GET параметри? Сложи заместители в адреса и ще пратим GET с попълнени стойности: {user} {ip} {vote_id} {server_id} {time} {country} {test} {sig}

https://your-site.com/vote_reward.php?name={user}&ip={ip}&id={vote_id}&t={time}&sig={sig}

Отговори с какъвто и да е 2xx статус. Ако сайтът ти не отговори, опитваме пак след 1 мин, 5 мин, 30 мин, 2 ч и 6 ч. Всеки опит е в дневника ти.

Пример на PHP

<?php
// vote_reward.php - called by MMOTop100 when a player voted
$secret = 'YOUR_POSTBACK_SECRET';            // My servers -> your server -> Keys
$in   = $_POST ?: $_GET;
$user = (string)($in['user'] ?? '');
$ip   = (string)($in['ip'] ?? '');
$vote = (string)($in['vote_id'] ?? '');
$sid  = (string)($in['server_id'] ?? '');
$time = (int)($in['time'] ?? 0);
$sig  = (string)($in['sig'] ?? '');

$want = hash_hmac('sha256', "$vote|$sid|$user|$ip|$time", $secret);
if (!hash_equals($want, $sig) || abs(time() - $time) > 86400) { http_response_code(403); exit('bad signature'); }
if (($in['test'] ?? '0') === '1') { exit('OK test'); }

// pay ONCE per vote_id (the same vote can arrive again if your answer got lost):
// INSERT INTO vote_log (vote_id, ...) with vote_id UNIQUE - if it already exists, do nothing.
// then give the reward to $user
echo 'OK';

3. Claim API - наградата за глас, взета веднъж

За плъгини на гейм сървъри и ботове: първото питане за глас връща claimed:true и го маркира като взет - всяко следващо казва, че е взет. Питай с IP-то и/или името на играча.

GET https://mmotop100.com/api/claim?server=SERVER_ID&key=API_KEY&ip=1.2.3.4&user=PLAYER_NAME
{"claimed":true,"vote_id":123,"at":1762900000}          = give the reward now (each vote only once)
{"claimed":false,"voted":true,"next":1762943200}        = already taken - can vote again at "next"
{"claimed":false,"voted":false}                         = no vote in the last 12 hours

Или ни попитай (API)

Ако сайтът ти не може да приема повиквания, питай дали IP или играч е гласувал в последните 12 часа:

GET https://mmotop100.com/api/voted?server=SERVER_ID&key=API_KEY&ip=1.2.3.4
GET https://mmotop100.com/api/voted?server=SERVER_ID&key=API_KEY&user=PLAYER_NAME

{"voted":true,"at":1762900000,"next":1762943200}   or   {"voted":false}

4. Правила