API

Материал из Warface

Перейти к: навигация, поиск
«Начни играть»

Главная / API

API — инструмент, позволяющий с лёгкостью создавать собственные приложения и веб-сайты, использующие данные об игроках Warface.

Ниже описаны форматы запроса и ответа, а также различные функции, например, данные об игроке, достижениях, предметах.

Формат запроса

Запросы необходимо отправлять методом GET.

Пример: http://api.warface.ru/user/achievements/?name=[ИМЯ_ПЕРСОНАЖА]&server=[НОМЕР_СЕРВЕРА]

При заполнении полей, например, [ИМЯ_ПЕРСОНАЖА] и [НОМЕР_СЕРВЕРА], квадратные скобки необходимо убирать.

Номера серверов:
   • 1 — «Альфа»,
   • 2 — «Браво»,
   • 3 — «Чарли».
Номера классов персонажей:
   • 1 — Штурмовик,
   • 2 — Медик,
   • 3 — Снайпер,
   • 4 — Инженер.

Формат ответа

API отдаёт данные в формате JSON.

Пример: [{"nickname":"имя1","clan":"-","class":"2","shard":"1"},{"nickname":"имя2","clan":"-","class":"2","shard":"1"}]

Описание функций

Рейтинг топ-100

Данный метод принимает следующие параметры:
   • «Сервер»,
   • «Класс».

В случае, если параметр не указан, данные выгружаются либо по всем серверам, либо по всем классам.

Пример: http://api.warface.ru/rating/top100?server=[СЕРВЕР]&class=[КЛАСС]

Рейтинг кланов

Данный метод принимает параметр «Сервер».

Пример: http://api.warface.ru/rating/clan?server=[СЕРВЕР]

Ежемесячный рейтинг

Данный метод принимает следующие параметры:
   • «Имя клана» (если передано, показывает данные аналогично опции «Мой клан» на сайте),
   • «Лига» (номера от 1 до 6).

Если используется параметр «Имя клана», в ответе от сервера будут данные о выбранном клане. Там же будет указана именно та лига, в которой этот клан находится, даже если в параметре «Лига» была выбрана не она. Если используется только параметр «Лига», сервер вернёт топ-100 для этой лиги.

Пример: http://api.warface.ru/rating/monthly?server=[СЕРВЕР]&clan=[ИМЯ_КЛАНА]&league=[ЛИГА_1–6]&page=[СТРАНИЦА]

Данные об игроке

Данный метод отдаёт статистику пользователя, принимает следующие параметры:
   • «Имя игрока»,
   • «Сервер».

Пример: http://api.warface.ru/user/stat/?name=[ИМЯ_ПЕРСОНАЖА]&server=[СЕРВЕР]

Данные о достижениях игрока

Данный метод принимает следующие параметры:
   • «Имя игрока»,
   • «Сервер».

Пример: http://api.warface.ru/user/achievements/?name=[ИМЯ_ПЕРСОНАЖА]&server=[СЕРВЕР]

Данные о предметах

Данный метод возвращает полный список доступных в игре предметов, с их id и названием.

Команда: http://api.warface.ru/weapon/catalog

Данные о достижениях

Данный метод возвращает полный список имеющихся в игре достижений, с их id и названием.

Команда: http://api.warface.ru/achievement/catalog

Источник — «https://wf.mail.ru/wiki/index.php/API»
Личные инструменты