Postback & Oylama API'si

Sunucunuza oy verdiklerinde oyuncularınızı otomatik olarak ödüllendirin.

Nasıl Çalışır?

Bir oyuncu RealmRanking üzerinden sunucunuza oy verdiğinde, sistemimiz yapılandırdığınız URL'ye bir HTTP GET veya POST isteği gönderir. Sunucunuz bu isteği alır ve oyuncuyu oyun içinde otomatik olarak ödüllendirebilir.

1Oyuncu RealmRanking tarihinde sunucunuza oy veriyor
2RealmRanking yapılandırılmış URL'nize bir Postback isteği gönderir
3Sunucunuz isteği doğrular ve oyuncuyu ödüllendirir

Postback URL'nizi Ayarlama

Sunucu kontrol panelinize gidin → Oylama API ayarları → Postback URL'nizi girin. URL'nin internetten herkesin erişimine açık olması gerekir.

Örnek URL biçimi

https://sunucunuz.com/vote?user={username}&id={server_id}&ip={ip}

Postback Parametreler

Her Postback isteğiyle birlikte aşağıdaki değişkenler gönderilir:

{username}Oyuncunun oy verirken girdiği oyun içi ad
{server_id}Benzersiz RealmRanking sunucu kimliğiniz
{timestamp}Oylamanın yapıldığı zamanı gösteren Unix zaman damgası
{ip}Seçmenin doğrulama için IP adresi

Örnek Uygulama

Postback isteğinin nasıl alınacağına ve işleneceğine ilişkin basit bir örnek:

PHP

<?php
$kullanıcıadı = $_GET['kullanıcıadı'];
$sunucu_id = $_GET['sunucu_id'];
// Oyun veritabanınızdaki oyuncuyu ödüllendirin
// Örnek: $username'e 100 oy jetonu verin
?>

Node.js (Express)

app.get('/vote', (req, res) => {
  const { username, server_id } = req.query;
  // Oyuncuyu ödüllendir
  res.sendStatus(200);
});

Postback Cihazınızı Test Etme

URL'nize simüle edilmiş bir oy göndermek ve URL'nin düzgün çalıştığını doğrulamak için sunucu kontrol panelinizdeki Postback Testi düğmesini kullanın.

Yeniden Deneme Politikası

Sunucunuz çevrimdışıysa veya URL bir hata döndürürse, RealmRanking, Postback'yi 24 saat içinde en fazla 3 kez yeniden deneyecektir. Başarısız denemeler kontrol panelinize kaydedilir.