За собственици на сървъри
Бутон за гласуване и callback.
Сложете бутон за гласуване на сайта си, за да гласуват играчите с едно кликване, и ги наградете в играта с подписан callback.
Обикновен линк за гласуване
Предпочитате собствен бутон? Пратете играчите директно към страницата за гласуване. Работи във всеки браузър и на мобилни устройства.
Линк за гласуване
https://mucompass.com/vote/your-serverНаградете играчите с callback
Включете „Награждавай играчите в играта, когато гласуват“ в обявата си и въведете callback адреса си. След всеки глас с име на герой MU Compass изпраща POST заявка с JSON тяло към този адрес.
Подписът е HMAC-SHA256 в шестнадесетичен вид на JSON обект само с полетата server, character и votedAt — в този ред и без интервали — с тайния ключ за callback на обявата ви като ключ.
Тяло на callback
Изпраща се като application/json.
{
"server": "ember-realm",
"character": "DarkKnight77",
"votedAt": "2026-10-25T21:42:00.000Z",
"signature": "9f2c6a1d0b7e4c3a8f5d2e1b6a9c0d7e4f3a2b1c8d9e0f7a6b5c4d3e2f1a0b9c"
}Проверете подписа
Винаги проверявайте подписа, преди да дадете награда, и давайте на всеки играч най-много една награда на 12 часа. Ето пример за Node.js сървър, написан на 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));
}Доставка и повторни опити
- Отговорете с какъвто и да е 2xx статус до 5 секунди.
- Ако сървърът ви не отговори или върне грешка, опитваме отново до 3 пъти.
- Гласовете без име на герой не се изпращат и се показват като „Пропуснат“.
- Всеки опит се вижда в „Последни гласове“ в таблото ви като Доставен, Пропуснат или Неуспешен.