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

สำหรับเจ้าของเซิร์ฟ

เพิ่มเซิร์ฟของคุณ ใส่ลิงก์โหวตในเว็บ และแจกรางวัลให้ผู้เล่นอัตโนมัติ มี 3 ขั้นตอน:

เลือกเกมของคุณ - หน้านี้จะแสดงสิ่งที่ต้องตั้งค่าสำหรับเกมนั้น

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 เพียงครั้งเดียว
userค่า u จากลิงก์โหวตของคุณ
ipIP address ของผู้โหวต
countryประเทศของผู้โหวต (ตัวอักษรสองตัว อาจว่างได้)
timeเวลา (unix วินาที, UTC)
test1 = ทดสอบจากแผงควบคุมของคุณ ห้ามแจกรางวัล
sigลายเซ็น: HMAC-SHA256 ของ "vote_id|server_id|user|ip|time" ด้วยรหัสลับ postback ของคุณ

เว็บของคุณอ่านค่า 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 ชม. ทุกครั้งจะอยู่ในบันทึก postback ของคุณ

ตัวอย่างใน 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. กฎ