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

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

Онлайн (закрытые игры)

Для игр без публичного протокола (Lineage II, WoW, MU Online и т.п.) число игроков нельзя узнать «снаружи». Вы сами присылаете онлайн из игровой БД раз в 1–5 минут. Данные свежие 15 минут — если дольше молчите, в каталоге снова только «сайт/порт доступен».

Где в кабинете Сервер → Онлайн API. Ключ тот же, что для наград (страница «Ключ и API»). Раздел есть только у игр с драйвером website.

Шаги

  1. Скопируйте API-ключ сервера.
  2. На игровом VPS сделайте скрипт: SELECT COUNT(*) … WHERE online=1 (или аналог) → POST к нам.
  3. Поставьте cron каждые 1–5 минут.
  4. На странице «Онлайн API» проверьте, что TopGam видит свежие данные.
POSThttps://topgam.ru/api/v1/status

Прислать текущий онлайн.

Параметры: online (число игроков), max — вместимость (необязательно). Ключ — Authorization: Bearer … (или поле key в теле POST).
{ "success": true, "online": 137, "max": 5000, "accepted_at": "…" }
GEThttps://topgam.ru/api/v1/status

Проверить, что TopGam видит ваши данные (fresh: true/false). Ключ — только в заголовке.

# Пример cron каждые 2 минуты
*/2 * * * * php /opt/topgam-online.php

# В скрипте:
# $online = (int) $db->query('SELECT COUNT(*) FROM characters WHERE online=1')->fetchColumn();
# POST https://topgam.ru/api/v1/status  Authorization: Bearer ВАШ_КЛЮЧ  + online=&max=

Готовый PHP-скелет — в разделе Примеры. Чужую ссылку на мониторинг в карточку сервера вставлять не нужно.

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