Документация API

Пошагово: где взять API-ключ, как настроить награды за голос и как присылать онлайн для закрытых игр (Lineage, WoW и т.п.).

Награды за голос

Очередь наград: игрок голосует с ником → мы кладём начисление → ваш сервер забирает pending и после выдачи делает claim. Без claim награда не потеряется и придёт снова.

Где в кабинете 1) Сервер → Награды — включить и добавить условия.
2) Сервер → Ключ и API — скопировать ключ и поставить скрипт/плагин.

Правильная настройка

  1. Включите «Выдавать награды игрокам».
  2. Добавьте хотя бы одно активное условие (обычно «За каждый голос» + команда или промокод).
  3. Для Minecraft / CS / Rust / SA-MP — доставка «Команда», скрипт по cron или плагин.
  4. Для Lineage / WoW и игр без консоли — «Промокод» или «Вручную» + свой сайт.
  5. Проверьте: проголосуйте тестовым аккаунтом с ником → в кабинете появится «в очереди» → после claim станет «выдано».
GEThttps://topgam.ru/api/v1/rewards/pending
Параметры: опционально nick, limit. Ключ — Authorization: Bearer … / X-Api-Key.
{
  "success": true,
  "count": 1,
  "rewards": [{
    "id": 128,
    "nick": "steve",
    "title": "Алмаз",
    "command": "give steve diamond 1",
    "promo_code": null
  }]
}

В command ник уже подставлен — выполняйте как есть.

POSThttps://topgam.ru/api/v1/rewards/claim
Параметры: id (или ids), либо nick. Ключ — Bearer / тело key (не в URL).
GEThttps://topgam.ru/api/v1/rewards/player

История и счётчики по нику (отладка, команда /votes).

Альтернатива опросу: Vote postback — мы сами стучимся на ваш HTTPS URL сразу после голоса. Примеры скриптов: Примеры.

Место сдаётся Ваш баннер 1160×90 от 120 ₽/сут · Смотреть цены →