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:
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_id | số máy chủ của bạn |
| vote_id | số phiếu - duy nhất; mỗi vote_id chỉ thưởng MỘT lần |
| user | giá trị u từ link bình chọn của bạn |
| ip | địa chỉ IP của người bình chọn |
| country | quốc gia của người bình chọn (hai chữ cái, có thể trống) |
| time | thời điểm (giây unix, UTC) |
| test | 1 = thử từ bảng điều khiển của bạn, không trao thưởng |
| sig | chữ 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
- Mỗi người một phiếu cho mỗi máy chủ mỗi 12 giờ (kiểm tra địa chỉ, trình duyệt và tài khoản người chơi).
- Mua phiếu, bot bình chọn, proxy và ép người chơi bình chọn từ nhiều kết nối = máy chủ bị xóa.
- Lượng phiếu tăng đột biến sẽ khiến máy chủ bị tạm khóa cho đến khi chúng tôi kiểm tra.
- Địa chỉ postback phải là công khai (không phải 127.0.0.1 hay mạng nội bộ). Chúng tôi không bao giờ theo chuyển hướng.
- Phiếu từ VPN, proxy, Tor và địa chỉ datacenter không được tính.