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

Dành cho chủ máy chủ

Thêm máy chủ, đặt link bình chọn lên website và tự động trao thưởng cho người chơi. Ba bước:

Chọn game của bạn - trang sẽ hiển thị chính xác những gì cần thiết lập.

1. Link bình chọn

Đặt link này lên website của bạn (SERVER_ID có trong Máy chủ của tôi):

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

u = tên tài khoản người chơi của bạn (chữ, số, _ . @ -, tối đa 64). Giá trị này được gửi lại trong postback để bạn biết cần thưởng cho ai.

2. Người chơi nhận thưởng thế nào

Postback - chúng tôi báo cho website của bạn rằng người chơi đã bình chọn

Sau mỗi phiếu được tính, chúng tôi gọi địa chỉ postback của bạn (POST, các trường form):

TrườngÝ nghĩa
server_idsố máy chủ của bạn
vote_idsố phiếu - duy nhất; mỗi vote_id chỉ thưởng MỘT lần
usergiá trị u từ link bình chọn của bạn
ipđịa chỉ IP của người bình chọn
countryquốc gia của người bình chọn (hai chữ cái, có thể trống)
timethời điểm (giây unix, UTC)
test1 = thử từ bảng điều khiển của bạn, không trao thưởng
sigchữ ký: HMAC-SHA256 của "vote_id|server_id|user|ip|time" với mã bí mật postback của bạn

Website của bạn đọc tham số GET? Đặt các placeholder vào địa chỉ và chúng tôi sẽ gửi GET với giá trị đã điền: {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}

Trả lời bằng bất kỳ mã 2xx nào. Nếu website của bạn không trả lời, chúng tôi thử lại sau 1 phút, 5 phút, 30 phút, 2 giờ và 6 giờ. Mọi lần thử đều có trong nhật ký postback.

Ví dụ bằng 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 - nhận thưởng một phiếu, một lần

Dành cho plugin máy chủ game và bot: lần gọi đầu cho một phiếu trả về claimed:true và đánh dấu đã nhận - các lần sau báo đã nhận. Hỏi bằng IP và/hoặc tên người chơi.

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

Hoặc hỏi chúng tôi (API)

Nếu website của bạn không nhận được lệnh gọi, hãy hỏi xem một IP hoặc người chơi đã bình chọn trong 12 giờ qua chưa:

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. Quy định