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

Материал из Игры ClanWars - браузерная игра из серии игр: Бойцовский клуб, Комбатс, Олд БК
(Новая страница: «<center>'''Clan Wars API'''</center> Взаимодействие между сервером Clan Wars происходит по HTTP-протоколу. Для...»)
 
Строка 30: Строка 30:
 
В ответ данные возвращаются в json формате. Массив имеет такие параметры:
 
В ответ данные возвращаются в json формате. Массив имеет такие параметры:
  
* "ok" — (bool) результат ответа: успех или неудача
+
* "'''ok'''" — (bool) результат ответа: успех или неудача
* "error_code" — (integer) код ошибки, при неудаче
+
* "'''error_code'''" — (integer) код ошибки, при неудаче
* "data" — (array) информация по запросу.
+
* "'''data'''" — (array) информация по запросу.
  
 
Данные, которые возвращаются в результате запроса:
 
Данные, которые возвращаются в результате запроса:
Строка 39: Строка 39:
 
1. Информация об игроке:
 
1. Информация об игроке:
  
* login<nowiki> [string]</nowiki>
+
* login<nowiki> [''string'']</nowiki>
* <nowiki>params [array]</nowiki>
+
* <nowiki>params [''array'']</nowiki>
* <nowiki>level [integer]</nowiki>
+
* <nowiki>level [''integer'']</nowiki>
* strength<nowiki> [integer]</nowiki>
+
* strength<nowiki> [''integer'']</nowiki>
* <nowiki>agility [integer]</nowiki>
+
* <nowiki>agility [''integer'']</nowiki>
* <nowiki>intuition [integer]</nowiki>
+
* <nowiki>intuition [''integer'']</nowiki>
* <nowiki>life [integer]</nowiki>
+
* <nowiki>life [''integer'']</nowiki>
* <nowiki>statistic [array]</nowiki>
+
* <nowiki>statistic [''array'']</nowiki>
* <nowiki>win [integer]</nowiki>
+
* <nowiki>win [''integer'']</nowiki>
* <nowiki>lose [integer]</nowiki>
+
* <nowiki>lose [''integer'']</nowiki>
* <nowiki>draw [integer]</nowiki>
+
* <nowiki>draw [''integer'']</nowiki>
* <nowiki>status [array]</nowiki>
+
* <nowiki>status [''array'']</nowiki>
* <nowiki>сlan_name [string]</nowiki>
+
* <nowiki>сlan_name [''string'']</nowiki>
* <nowiki>clan_status_name [string]</nowiki>
+
* <nowiki>clan_status_name [''string'']</nowiki>
* <nowiki>town [string]</nowiki>
+
* <nowiki>town [''string'']</nowiki>
* <nowiki>reg_date [string]</nowiki>
+
* <nowiki>reg_date [''string'']</nowiki>
* <nowiki>marriage [array]</nowiki>
+
* <nowiki>marriage [''array'']</nowiki>
* <nowiki>partner [string]</nowiki>
+
* <nowiki>partner [''string'']</nowiki>
* <nowiki>blank [string]</nowiki>
+
* <nowiki>blank [''string'']</nowiki>
* <nowiki>skills [arrays]</nowiki>
+
* <nowiki>skills [''arrays'']</nowiki>
* <nowiki>master [</nowiki>integer]
+
* <nowiki>master [</nowiki>''integer'']
* name<nowiki> [string]</nowiki>
+
* name<nowiki> [''string'']</nowiki>
  
 
2. Информация о клане:
 
2. Информация о клане:
  
* name<nowiki> [string]</nowiki>
+
* name<nowiki> [''string'']</nowiki>
* birth<nowiki> [string]</nowiki>
+
* birth<nowiki> [''string'']</nowiki>
* level <nowiki>[integer]</nowiki>
+
* level <nowiki>[''integer'']</nowiki>
* site<nowiki> [string]</nowiki>
+
* site<nowiki> [''string'']</nowiki>
* castle_level <nowiki>[integer]</nowiki>
+
* castle_level <nowiki>[''integer'']</nowiki>
* members<nowiki> [array</nowiki>s]
+
* members<nowiki> [''array''</nowiki>s]
* <nowiki>clan_status_name [string]</nowiki>
+
* <nowiki>clan_status_name [''string'']</nowiki>
* login<nowiki> [string]</nowiki>
+
* login<nowiki> [''string'']</nowiki>
  
 
Коды ошибок:
 
Коды ошибок:

Версия 14:04, 29 июля 2014

Clan Wars API


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


Для получения информации необходимо послать 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'']
  • 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 [''array''s]
  • clan_status_name [''string'']
  • login [''string'']

Коды ошибок:


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

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

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

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

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