· 1 мин чтения · skaen
API для разработчиков: данные, статистика и награда за голос
Владельцы серверов могут получать данные и статистику сервера на своём сайте и выдавать игрокам награду за голос: ключ создаётся в личном кабинете.
В HSZN появилось API для сайтов серверов. Теперь на своём сайте вы можете показывать данные сервера из мониторинга, статистику и отзывы, а игрокам выдавать игровую валюту или привилегию за голос.
Ключ в личном кабинете
Ключ создаёт владелец сервера: откройте «Настройки → API-ключ» и нажмите «Создать ключ».
- Ключ один на аккаунт и подходит ко всем вашим серверам
- Ключ показывается один раз, сохраните его у себя
- Его можно перевыпустить или отозвать: старый ключ перестанет работать сразу
- Ключа ещё нет? Сначала добавьте сервер и подтвердите владение
Что можно получить
- Данные любого сервера: название, карта, онлайн, рейтинг — то же, что видно на сайте
- Статистику за 1, 7, 14 и 30 дней
- Отзывы о сервере (только чтение)
- Добавление новых серверов и подтверждение владения из вашей панели
Награда за голос
Игрок голосует кнопкой «Проголосовать» на странице вашего сервера и заходит на ваш сайт, например через Steam. Ваш сервер спрашивает HSZN, голосовал ли этот игрок, и выдаёт награду.
- Голосовать можно раз в сутки, поэтому награда не выдаётся дважды за один голос
- Чтобы голос можно было узнать, игроку нужно привязать Steam в профиле HSZN
- Проверка голосов доступна только с ключем владельца сервера
Примеры и ограничения
В описании есть готовые примеры на JavaScript, React, PHP и curl: у каждого метода показаны запрос и ответ. Число запросов ограничено, а данные сервера обновляются раз в 10 минут.
Подключите свой сайт
Все методы описаны на странице для разработчиков. Если что-то не получается, напишите в поддержку.
