Категория:API — различия между версиями

Текущая версия на 08:47, 29 сентября 2014

Взаимодействие между сервером Clan Wars происходит по HTTP-протоколу.

API выдаёт информацию в json формате, кодировка UTF-8.

Для получения информации необходимо послать POST/GET-запрос по адресу:

http://cwars.ru/public_api.php

Получения информации:

1. Информация об игроке.

Параметры запроса:

http://cwars.ru/public_api.php?info=user&login={user_login}, где

{user_login} — логин пользователя

2. Информация о клане.

http://cwars.ru/public_api.php?info=clan&name={clan_name}, где

{clan_name} — название клана

В ответ данные возвращаются в json формате. Массив имеет такие параметры:

• "ok" — (bool) результат ответа: успех или неудача
• "error_code" — (integer) код ошибки, при неудаче
• "data" — (array) информация по запросу.

Данные, которые возвращаются в результате запроса:

1. Информация об игроке:

• login [string]
• sex [string] - имеет два варианта обозначения: m - мужской пол; f - женский пол
• params [array]
  • level [integer]
  • strength [integer]
  • agility [integer]
  • intuition [integer]
  • life [integer]
• statistic [array]
  • win [integer]
  • lose [integer]
  • draw [integer]
• status [array]
  • сlan_name [string]
  • clan_status_name [string]
  • town [string]
  • reg_date [string]
  • marriage [array]
    • partner [string]
    • blank [string]
• skills [arrays]
  • master [integer]
  • name [string]

2. Информация о клане:

• name [string]
• birth [string]
• level [integer]
• site [string]
• castle_level [integer]
• members [arrays]
  • clan_status_name [string]
  • login [string]
  • level [integer]
  • sex [string] - имеет два варианта обозначения: m - мужской пол; f - женский пол

Коды ошибок:

* фатальность – при повторном запросе результат не изменится (ошибка не временная)