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

Материал из Игры ClanWars - браузерная игра из серии игр: Бойцовский клуб, Комбатс, Олд БК
 
(не показаны 2 промежуточные версии этого же участника)
Строка 4: Строка 4:
 
Взаимодействие между сервером Clan Wars происходит по HTTP-протоколу.
 
Взаимодействие между сервером Clan Wars происходит по HTTP-протоколу.
  
API выдаёт информацию в формате UTF-8.
+
API выдаёт информацию в json формате, кодировка UTF-8.
  
 
Для получения информации необходимо послать POST/GET-запрос по адресу:  
 
Для получения информации необходимо послать POST/GET-запрос по адресу:  
Строка 41: Строка 41:
  
 
* login [''string'']
 
* login [''string'']
 +
* sex [''string''] - имеет два варианта обозначения: m - мужской пол; f - женский пол
 
* params [''array'']
 
* params [''array'']
 
** level [''integer'']
 
** level [''integer'']
Строка 73: Строка 74:
 
** clan_status_name [''string'']
 
** clan_status_name [''string'']
 
** login [''string'']
 
** login [''string'']
 +
** level [integer]
 +
** sex [string] - имеет два варианта обозначения: m - мужской пол; f - женский пол
  
 
Коды ошибок:
 
Коды ошибок:

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

Clan Wars API


Взаимодействие между сервером 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 - женский пол

Коды ошибок:


Код ошибки
Описание
Фатальность*
0
Успех
-
104
Неверно задан параметр info
+
128
Неверно задан параметр login
+
147
Неверно задан параметр name
+
150
Сервер занят, повторите запрос позже
-

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

Эта категория в данный момент пуста.

Персональные инструменты

Пространства имён