İçeriğe geç

Discord oy ödülü kurulumu

Oyuncu oy verdiği anda sunucuna bir istek gelir; ödülü sen verirsin. Webhook ile beş adımda kurulur.

  1. 1

    Webhook adresini gir

    Hesabım › Sunucularım › Oy ödülü bölümüne, oy geldiğinde çağrılacak adresi (sitenin, botunun ya da sunucu yönetim aracının adresi) ve en az 16 karakterlik bir gizli anahtar yaz.

    Sunucularım'a git

  2. 2

    İmzayı doğrula

    Her istek gizli anahtarınla HMAC-SHA256 ile imzalanır. İmza X-Sunuculari-Signature başlığındadır; imzalanan metin X-Sunuculari-Timestamp başlığındaki zaman, nokta ve istek gövdesidir. İmzası tutmayan isteği reddet.

    İmza denetimi (PHP)
    $govde = file_get_contents('php://input');
    $imza  = 'sha256=' . hash_hmac('sha256', $_SERVER['HTTP_X_SUNUCULARI_TIMESTAMP'] . '.' . $govde, $gizliAnahtar);
    if (!hash_equals($imza, $_SERVER['HTTP_X_SUNUCULARI_SIGNATURE'] ?? '')) {
        http_response_code(401); exit;
    }
  3. 3

    Oyu oku

    Oy geldiğinde adresine şu gövdeyle bir POST isteği gelir; 2xx yanıt ver.

    İstek gövdesi (JSON)
    {
      "event": "vote",
      "test": false,
      "username": "Asena",
      "game": "discord",
      "server": {
        "key": "2-14",
        "name": "Sunucun",
        "url": "https://discord.sunuculari.com/sunucu/sunucun/"
      },
      "timestamp": 1761326043
    }
  4. 4

    Ödülü oyunda ver

    Botun oy veren üyeye bir rol versin (ör. "Oy veren") ya da özel bir kanalı açsın.

  5. 5

    Oyunda kontrol et (isteğe bağlı)

    Oyuncu oyunda /oy yazdığında son 24 saatte oy verip vermediğini sorgulayabilirsin:

    Oy sorgusu
    GET https://sunuculari.com/wp-json/vgnw-directory/v1/oy/2-14/Asena
    
    { "oy_verdi": true, "son_oy": "2026-10-24T20:14:03+03:00", "sonraki_oy": "2026-10-25T20:14:03+03:00" }