Инструменты пользователя

Инструменты сайта


Боковая панель












api

API

Для клановых умельцев сервер игры предоставляет удобный доступ к некоторым данным.

Список расширяется по мере затребованности тех или иных данных/услуг.

С предложениями и пожеланиями обращайтесь к Ремесленнику.

"Неизменяемые" справочники

Ряд справочников, которые меняются очень редко и могут быть вам полезны, мы сложили в ZIP-файл.
Загрузить вы его можете по ссылке http://oldbk.ru/api/refexport.php.
Каждый справочник в отельном файле в формате json кодировка WINDOWS-1251.

thing - шмотки
thingRazdel - разделы шмоток (оружие/одежда/подарки и т.д.)
thingOtdel - отделы шмотья (топоры/дубины/букеты/сувениры и т.п.)
bonusByStat - бонусы за статы

Таблица опыта

  http://oldbk.ru/api/api.php?q=exptable&out=lib

Как это выглядит

Если кого интересуют другие форматы вывода - стучитесь в приват.

Кланы

Cписок кланов

http://oldbk.ru/api/api.php?q=clan.list
Array
(
  [status] => ok
  [message] => 
  [clans] => Array
      (
          [1] => Array
              (
                  [id] => 1
                  [title] => DarkLaw
                  [glavaId] => 74312
                  [align] => 3
                  [www] => http://olddarklaw.clan.su
                  [memberCount] => 27
              )
          [n] => Array...
      )
)

Список участников клана

  http://oldbk.ru/api/api.php?q=clan.members&clanId=34&out=json

Параметр out может принимать одно из значений: json, serialize, demo.
Для вывода json поддерживается JSONP (обрабатывается параметр jsoncallback)

Ответ сервера в формате json.

  { "status"  : "ok",  # 'ok' или 'error'
    "message" : null,  # текст ошибки
    "clanId"  : "34",  # ID запрашиваемого клана
    "members": {       # список членов клана
        "14939": {       # ID персонажа
          "id"             : "14939",        # ID персонажа
          "login"          : "gelios",       # логин
          "align"          : "2.8",          # склонность
          "level"          : "8",            # уровень
          "isOnline"       : "0",            # 0|1 признак онлайна
          "status"         : "текст"         # Статус в клане
          "lastActiveTime" : "1320697822",   # последнее время активности. (UNIX-time)
          "lastActiveStr"  : "16 ч. 19 мин." # текстовый вариант предыдущего поля "был замечен последний раз ..."
                                             # дальше идет список полей для генерации ника персонажа
          "u_id"        : "14939",           # список и значения этих полей могут изменится
          "u_login"     : "gelios",          # назначение полей будет описано ниже и позже.
          "u_align"     : "2.8",
          "u_level"     : "8",
          "u_clanId"    : "radminion",
          "u_clanTitle" : "radminion",
        },
        "9577": { ...},
        ...
    }
  } 

В случае ошибки поле статус будет иметь значение 'error' и текст ошибки будет указан в поле 'message'

В поле lastActiveTime устанаваливается время (UNIX-time) последней активности (смена локации, удар в бою, обновление чата и т.п.) или время применения эффекта «невидимка».

Пример JSONP вызова и «самое интересное» из него

  $(document).ready(function(){
 
    $.getJSON('http://oldbk.ru/api/api.php?jsoncallback=?',
 
                  {q:'clan.members', clanId:34, out:'json'},
 
                  function(data){
 
                    $('pre').text(dump(data));
 
                  }
 
               );
 
  });
Как узнать id клана?

Башня смерти

Список групп, ожидающих начало турнира, и/или текущие турниры

  http://oldbk.ru/api/api.php?q=towerd.groups&[out=json|serialize|demo][&expected=1|0][&current=0|1]

Параметр out может принимать одно из значений: json, serialize, demo.
Для вывода json поддерживается JSONP (обрабатывается параметр jsoncallback)

expected - выводить ожидающие группы (по умолчанию 1)1)

current - выводить текущие турниры (по умолчанию 0)

Ответ сервера.

Array
(
    [status] => Ok
    [error] => 
    [groups] => Array
        (
            [0] => Array
                (
                    [entryId] => 31
                    [levelMax] => 7
                    [levelMin] => 7
                    [startTime] => 1327370864
                    [startTimeStr] => 24.01.2012 04:07:44                    
                    [title] => артовая
                    [minimalBet] => 300
# для ожидающих групп поля пустые. Для активного турнира указаны номер турнира и время старта                     
                    [tournirId] => 
                    [tournirStartTime] =>                    
# информация по боту                    
                    [u_id] => 84
                    [u_login] => Библиотекарь
                    [u_align] => 2.3
                    [u_level] => 7
                    [u_clanId] => 
                    [u_clanTitle] => 
                )
           ...
        )

)                
Для просмотра лога турнира, можно воспользоваться коротким вариантом ссылки
http://oldbk.ru/towerd/log.php?TOURNIR_ID

Жертвенный камень

Текущий рейтинг

  http://oldbk.ru/api/api.php?q=credenza.rating&[out=json|serialize|demo]

Ответ сервера

Array
(
    [status] => Ok
    [error] => 
    [timestamp] => 1365424131
    [winLight] => 40
    [winDark] => 63
)
1)
Для обратной совместимостью с предыдущей версией запроса
api.txt · Последнее изменение: 2015/09/21 14:14 — root