API для разработчиков
Показывайте данные своего сервера на своём сайте, добавляйте серверы из панели и выдавайте игрокам награду за голос. Ключ создаёт владелец сервера в личном кабинете.
- 1
Подтвердите сервер
Ключ доступен владельцам. Добавьте сервер на сайте и подтвердите владение: впишите код в начало названия и нажмите «Проверить».
- 2
Создайте ключ
В кабинете откройте «Настройки», раздел «API-ключ». По умолчанию ключа нет, его нужно создать. Он показывается один раз, сохраните его у себя на сервере.
- 3
Запрашивайте данные
Передавайте ключ в заголовке запроса и читайте онлайн, статистику и голоса.
Первый запрос
Каждый запрос идёт с заголовком Authorization: Bearer hszn_…. Базовый адрес: https://hszn.ru/api/v1. Ответы приходят в JSON.
# Данные вашего сервера
curl "https://hszn.ru/api/v1/servers/1042" \
-H "Authorization: Bearer $HSZN_KEY"Все методы с примерами ответов — на вкладке «Методы».
Что можно получить
Данные любого сервера. Название, карта, онлайн, рейтинг, отзывы и статистика за 1, 7, 14 и 30 дней. Это те же данные, что видны на сайте.
Голоса только по вашим серверам. Список проголосовавших и проверка игрока доступны владельцу сервера. Не вставляйте ключ в код страницы: отправляйте запросы со своего сервера.
БесплатноКлюч и запросы без оплаты в пределах лимитов
БезопасноКлюч можно перевыпустить или отозвать, старый перестанет работать сразу
Свежие данныеОнлайн обновляется каждые 10 минут
ПоддержкаНе получается подключить? Напишите нам в поддержку