HSZN
Итоги годаДобавить сервер

API для разработчиков

Показывайте данные своего сервера на своём сайте, добавляйте серверы из панели и выдавайте игрокам награду за голос. Ключ создаёт владелец сервера в личном кабинете.

Перейти к ключу

Типичная схема для сайта сервера: игрок входит через Steam, нажимает «Получить награду», ваш сервер спрашивает HSZN и выдаёт валюту один раз за голос.

  1. 1Игрок голосуеткнопкой «Проголосовать» на странице вашего сервера, раз в 24 часа
  2. 2Заходит к вамчерез Steam, вы знаете его SteamID
  3. 3Вы спрашиваете HSZNметодом проверки голоса
  4. 4Выдаёте наградуи запоминаете номер голоса
// SteamID берите из сессии игрока (после входа через Steam), а не из запроса: запрос можно подделать
const steamId = session.steamId;

const res = await fetch(
  `https://hszn.ru/api/v1/servers/1042/votes/check?steamid=${steamId}`,
  { headers: { Authorization: `Bearer ${process.env.HSZN_KEY}` } }
);
const vote = await res.json();

// этот голос ещё не награждали: начисляем валюту
if (vote.voted && !(await alreadyRewarded(vote.voteId))) {
  await giveCurrency(steamId, 100);
  await markRewarded(vote.voteId);
}

Награда только тем, у кого привязан Steam. Если игрок голосовал, но не привязал Steam, узнать его мы не можем. Покажите ему подсказку: «Привяжите Steam в профиле HSZN, чтобы получить награду».