Pentru proprietarii de servere
Buton de vot și callback.
Pune un buton de vot pe site-ul tău ca jucătorii să voteze dintr-un click, apoi recompensează-i în joc printr-un callback semnat.
Link simplu de vot
Preferi propriul buton? Trimite jucătorii direct la pagina ta de vot. Funcționează în orice browser și pe mobil.
Link de vot
https://mucompass.com/vote/your-serverRecompensează jucătorii prin callback
Activează „Recompensează jucătorii în joc când votează” în listarea ta și introdu URL-ul de callback. După fiecare vot cu nume de personaj, MU Compass trimite o cerere POST cu un body JSON către acel URL.
Semnătura este un HMAC-SHA256 în hex al unui obiect JSON care conține doar câmpurile server, character și votedAt — în această ordine și fără spații — folosind drept cheie secretul de callback al listării tale.
Body-ul callback-ului
Trimis ca application/json.
{
"server": "ember-realm",
"character": "DarkKnight77",
"votedAt": "2026-10-25T21:42:00.000Z",
"signature": "9f2c6a1d0b7e4c3a8f5d2e1b6a9c0d7e4f3a2b1c8d9e0f7a6b5c4d3e2f1a0b9c"
}Verifică semnătura
Verifică întotdeauna semnătura înainte de a acorda o recompensă și oferă fiecărui jucător cel mult o recompensă la 12 ore. Iată un exemplu pentru un server Node.js scris în 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));
}Livrare și reîncercări
- Răspunde cu orice status 2xx în maximum 5 secunde.
- Dacă serverul tău nu răspunde sau returnează o eroare, reîncercăm de până la 3 ori.
- Voturile fără nume de personaj nu sunt trimise și apar ca „Omis”.
- Fiecare încercare apare la Voturi recente în panoul tău ca Livrat, Omis sau Eșuat.