Dla właścicieli serwerów
Przycisk głosowania i callback.
Umieść przycisk głosowania na swojej stronie, aby gracze mogli głosować jednym kliknięciem, a potem nagradzaj ich w grze dzięki podpisanemu callbackowi.
Zwykły link do głosowania
Wolisz własny przycisk? Kieruj graczy bezpośrednio na swoją stronę głosowania. Działa w każdej przeglądarce i na telefonie.
Link do głosowania
https://mucompass.com/vote/your-serverNagradzaj graczy dzięki callbackowi
Włącz opcję „Nagradzaj graczy w grze za głosowanie” w swoim serwerze i podaj URL callbacku. Po każdym głosie z nazwą postaci MU Compass wysyła na ten URL żądanie POST z treścią JSON.
Podpis to szesnastkowy HMAC-SHA256 obiektu JSON zawierającego tylko pola server, character i votedAt — w tej kolejności i bez spacji — z sekretem callbacku Twojego serwera jako kluczem.
Treść callbacku
Wysyłana jako application/json.
{
"server": "ember-realm",
"character": "DarkKnight77",
"votedAt": "2026-10-25T21:42:00.000Z",
"signature": "9f2c6a1d0b7e4c3a8f5d2e1b6a9c0d7e4f3a2b1c8d9e0f7a6b5c4d3e2f1a0b9c"
}Zweryfikuj podpis
Zawsze weryfikuj podpis przed przyznaniem nagrody i dawaj każdemu graczowi maksymalnie jedną nagrodę na 12 godzin. Oto przykład dla serwera Node.js napisanego w TypeScript.
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));
}Dostarczanie i ponowienia
- Odpowiedz dowolnym statusem 2xx w ciągu 5 sekund.
- Jeśli Twój serwer nie odpowie lub zwróci błąd, ponowimy próbę do 3 razy.
- Głosy bez nazwy postaci nie są wysyłane i mają status „Pominięto”.
- Każda próba jest widoczna w sekcji Ostatnie głosy w Twoim panelu jako Dostarczono, Pominięto lub Błąd.