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

С чего начать

1. Ключ API — кабинет → ваш сервер → «Ключ и API». Там длинная строка — это api_key. Копируете и храните как пароль. Передаётся только заголовком Authorization: Bearer … или X-Api-Key (в URL ?key= — нельзя: ключ попадёт в логи).
2. Награды за голос — кабинет → сервер → «Награды»: включите переключатель, добавьте условие (хотя бы «За каждый голос»), затем на странице «Ключ и API» поставьте скрипт/плагин, который раз в минуту забирает очередь GET https://topgam.ru/api/v1/rewards/pending и подтверждает POST https://topgam.ru/api/v1/rewards/claim. Подробно: Rewards и Примеры.
3. Онлайн для закрытых игр (Lineage II, WoW, MU Online и т.п.) — кабинет → сервер → «Онлайн API». Раз в 1–5 минут ваш cron шлёт POST https://topgam.ru/api/v1/status с числом игроков из игровой БД. Чужую ссылку на «статус» в форму сервера вставлять не нужно. Подробно: Status.
4. Мгновенная выдача после голоса — укажите HTTPS postback URL на странице «Ключ и API». Мы сами POST’им JSON при голосе. Подробно: Postback.

Base URL: https://topgam.ru/api/v1.

• Vote — проверка и claim голоса по нику (pull).
• Postback — мы сами POST’им на ваш URL при голосе.
• Status — прислать онлайн (закрытые игры).
• Rewards — очередь наград за голос/серию/отзыв.
• Примеры — curl, PHP cron, скелеты плагинов.