Подключение TournamentService API 1.0

Прежде чем использовать функции API, необходимо загрузить в браузер JavaScript-файлы, в которых эти функции определены. Для этого добавьте в заголовок head HTML-страницы следующие строки:

 <script src="http://tournamentservice.net/scripts/JsHttpRequest.js"></script>
 <script src="http://tournamentservice.net/scripts/tournaments.js"></script>

Внимание! Все компоненты TournamentService API принадлежат глобальному пространству имен!

Для передачи запросов на tournamentservice.net и получения данных, используется библиотека JsHttpRequest от Dmitry Koterov, http://en.dklab.ru/lib/JsHttpRequest/

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

LoadTournament([request:Object])

загружаются данные соответствующие запросу request
Если параметр не указан, в качестве запроса будет использованна переменная request библиотеки tournaments.js

Возвращает массив {data:'результат запроса', count:'количество строк', ev:'дополнительные скрипты'} и заполняет элемент с id=request.target данными

LoadRanking([request:Object])

LoadPlayer([request:Object])

LoadReferee([request:Object])

LoadVideo([request:Object])

LoadClip(matchID:Integer, [onload:String])

Загружает плеер с кодом видео соответствующей встречи

Переменные TournamentService API 1.0

request:Object

запрос, который будет выполняться при вызове любой из функциий Load() без параметров;

now:Date

текущая дата. Можно использовать все методы объекта Date;

spinner:String

Заполнитель, который будет отображаться во время выполнения запроса.

По умолчанию задан анимированный gif
var spinner='<img src="http://tournamentservice.net/images/spin1.gif" alt="Загрузка данных ...">';

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

target:String

Обязательный параметр! ID элемента, в который будут загружаться данные;

template:String

шаблон вывода данных (default - по умолчанию). Если в качестве шаблона указано 'JSON' будет возвращён не HTML-код, а JSON-объект соответствующий запросу;

org:Integer/String

ID организации. В строковом варианте, через запятую, можно указать несколько значений;

club:Integer

ID бильярдного клуба;

base:String

базовый адрес для возвращаемых ссылок;

Например, если вы вызываете функцию LoadTournament() для отображения актуальных событий на главной странице вашего сайта http://mySite.com/index.html, а страница с турнирами находится по адресу http://mySite.com/events.html, то в качестве значения этого параметра надо указать абсолютную или относительную ссылку на страницу турниров request.base='events.html'

calendar:Boolean

список всех турниров из календаря организации если истина, иначе только турниры организации;

category:Integer/String

категория турниров (0-клубные, 1-региональные, 2-национальные, 3-международные);

city:String

город проведения турниров;

country:String

трёхбуквенный код страны по ISO-3166-1;

disc:String

дисциплина турниров (pyr, pool, snk, carom);

limit:Integer

максимальное количество возвращаемых элементов;

month:Number

месяц проведения турниров. Допускаются значения от -1 до 12 (0 - по умолчанию). При установке -1 будут выведенны турниры в диапазоне ±60 дней от текущей даты, при 0 - весь год, остальные значения соответствуют номеру месяца. Текущий месяц можно получить из переменной now: request.month=now.getMonth()+1 ;

onload:String

JavaScript код, выполняемый после загрузки данных;

order:String

порядок сортировки по дате(asc/desc);

search:String

строка для поиска в названии турнира;

stat:String

текущее состояние турнира (add, link, reg, seed, inst, run, end) Можно указать несколько значений, разделив их запятыми;

year:Number

год проведения турниров (текущий по умолчанию). Для получения текущего года можно воспользоваться переменной now вызвав её метод getFullYear() request.year=now.getFullYear() ;