API Documentation

Complete reference for integrating with our voting system. Choose the integration method that best fits your needs.

Authentication

All API endpoints require authentication using API keys. Get your keys from the dashboard.

// Include in all API requests
{
    "api_key": "your-api-key",
    "api_secret": "your-api-secret"
}

Simple Integration

The easiest way to get started. No API calls required.

<a href="https://mmo100.top/in?u=your-game-slug&a=in" 
   target="_blank" 
   class="vote-button">
    🗳️ Vote for Our Server
</a>

Postback System

Real-time vote confirmations sent to your server.

POST /your-postback-url
Content-Type: application/x-www-form-urlencoded

pingUsername=PlayerName
vote=1
timestamp=1234567890

{
    "game_id": 123,
    "api_key": "your-api-key",
    "user_id": 456,
    "ip_address": "192.168.1.1",
    "vote_value": 1,
    "timestamp": 1234567890,
    "signature": "generated-signature"
}

{
    "success": true,
    "message": "Vote recorded successfully",
    "vote_id": 789,
    "total_votes": 150
}

Incentive Voting

Reward players for voting with in-game items, currency, or experience.

{
    "game_id": 123,
    "api_key": "your-api-key",
    "player_name": "PlayerName",
    "player_ip": "192.168.1.1",
    "vote_value": 1,
    "reward_type": "currency",
    "reward_amount": 1000,
    "reward_item": "Gold",
    "timestamp": 1234567890,
    "signature": "generated-signature"
}

{
    "success": true,
    "message": "Vote recorded successfully",
    "vote_id": 789,
    "total_votes": 150,
    "reward": {
        "id": 456,
        "type": "currency",
        "amount": 1000,
        "item": "Gold",
        "status": "approved"
    },
    "reward_status": "approved"
}

Signature Generation

All API requests require a signature for security. Here's how to generate it.

<?php
function generateSignature($data, $secret) {
    // Remove signature from data
    unset($data['signature']);
    
    // Sort data alphabetically by key
    ksort($data);
    
    // Create query string
    $queryString = http_build_query($data);
    
    // Generate HMAC signature
    return hash_hmac('sha256', $queryString, $secret);
}

// Example usage
$data = [
    'game_id' => 123,
    'api_key' => 'your-api-key',
    'player_name' => 'PlayerName',
    'vote_value' => 1,
    'timestamp' => time()
];

$signature = generateSignature($data, 'your-api-secret');
$data['signature'] = $signature;
?>

Error Codes

Rate Limits