Воспользоваться API SQUAD TOOLS можно только после регистрации аккаунта и добавления клана на сервисе.
Чтобы получать данные о клане и его участниках, необходимо получить токен.
Авторизуйтесь, затем, перейдите в «Мои кланы» → Выберите клан в списке доступных → Перейдите в раздел «API».
Если API ранее не было подключено, нажмите на кнопку «Получить токен». Через несколько секунд на экране появится токен. Не публикуйте его и не передавайте посторонним — с помощью токена возможно получить информацию о вашем клане и его участниках.
Получение данных
Запрос к API SQUAD TOOLS выглядит следующим образом:
Для запроса понадобятся некоторые параметры из таблицы ниже. Для каждого параметра есть своё назначение, благодаря которым можно получить необходимый набор данных.
Параметр
Использование
Описание
token
обязательно
токен клана, для которого будет выведена информация
request
обязательно
вид запрашиваемых данных:
user
,
users
или
clans
query
необязательно
параметры к виду запрашиваемых данных, позволяющие уточнить поиск
Параметр
Тип данных
Описание
id
уникальный, int
порядковый номер записи в сервисе
username
не уникальный, string
имя пользователя, используемое в игре
steamId
уникальный, string
номер аккаунта Steam
Параметр
Тип данных
Возвращаемые значения
Описание
result
int
0 при успехе1 при ошибке
результат выполнения запроса, при неуспешном — ознакомьтесь со значением параметра «message»
message
string
—
комментарий при неуспешном выполнении запроса
users
array
user
массив участников клана
clans
array
clan
массив кланов, зарегистрированных на сервисе
user
array
id, username, steamId, memberStatus
данные об участнике клана
clan
array
id, tag, name
данные о клане
Примеры использования
Запрос для получения списка участников клана:
Ответ:
Запрос для получения участника клана по steamId:
Ответ:
Ограничения
API SQUAD TOOLS отслеживает адекватность количества отправляемых запросов и может ограничить доступ к API на некоторое время.