Server sahipleri için
Oy butonu ve callback.
Oyuncuların tek tıkla oy verebilmesi için web sitene bir oy butonu koy, sonra onları imzalı bir callback ile oyun içinde ödüllendir.
Düz oy bağlantısı
Kendi butonunu mu tercih edersin? Oyuncuları doğrudan oy sayfana yönlendir. Her tarayıcıda ve mobilde çalışır.
Oy bağlantısı
https://mucompass.com/vote/your-serverOyuncuları callback ile ödüllendir
İlanında “Oy veren oyuncuları oyun içinde ödüllendir” seçeneğini aç ve callback URL'ni gir. Karakter adı içeren her oydan sonra MU Compass bu URL'ye JSON gövdeli bir POST isteği gönderir.
İmza, yalnızca server, character ve votedAt alanlarını — bu sırayla ve boşluksuz — içeren bir JSON nesnesinin, anahtar olarak ilanının callback secret'ı kullanılarak hesaplanan hex HMAC-SHA256 değeridir.
Callback gövdesi
application/json olarak gönderilir.
{
"server": "ember-realm",
"character": "DarkKnight77",
"votedAt": "2026-10-25T21:42:00.000Z",
"signature": "9f2c6a1d0b7e4c3a8f5d2e1b6a9c0d7e4f3a2b1c8d9e0f7a6b5c4d3e2f1a0b9c"
}İmzayı doğrula
Ödül vermeden önce imzayı her zaman doğrula ve her oyuncuya 12 saatte en fazla bir ödül ver. İşte TypeScript ile yazılmış bir Node.js serverı için bir örnek.
verify-vote.ts
import { createHmac, timingSafeEqual } from "node:crypto";
type VotePayload = {
server: string;
character: string;
votedAt: string;
signature: string;
};
export function isValidVote(payload: VotePayload, secret: string) {
const body = JSON.stringify({
server: payload.server,
character: payload.character,
votedAt: payload.votedAt,
});
const expected = createHmac("sha256", secret).update(body).digest("hex");
const received = payload.signature;
return expected.length === received.length && timingSafeEqual(Buffer.from(expected), Buffer.from(received));
}İletim ve yeniden denemeler
- 5 saniye içinde herhangi bir 2xx durum koduyla yanıt ver.
- Serverın yanıt vermezse ya da hata döndürürse 3 kereye kadar yeniden deneriz.
- Karakter adı olmayan oylar gönderilmez ve “Atlandı” olarak görünür.
- Her deneme panelindeki Son oylar bölümünde İletildi, Atlandı ya da Başarısız olarak listelenir.