AJAX-API форума Миста.ру| Движок форума Миста.ру местами поддерживает ajax-вызовы. Тут перечислены некоторые функции с примерами вызовов. Ajax-api может быть использовано как в пользовательских скриптах, так и для доступа к материалам форума с других сайтов, а в перспективе, и к созданию альтернативных клиентов. | | Автор статьи: Asmody | Редакторы: romix, Nirvana
Последняя редакция №14 от 21.01.13 | История
URL: http://kb.mista.ru/article.php?id=796 | |
Ключевые слова: ajax, ajax-api, json, javascript, Волшебный форум, Миста, mista, описание, engine
Получение данных/ajax_index.php - список тем форума.параметры: - topics - число тем, которые нужно вернуть (по умолчанию - 20);
- utime - время (в формате unixtime) после которого надо вернуть ветки;
- callback - если указано, то ответ заворачивается в вызов функции, имя которой передано в параметре (реализация JSONP);
- section_short_name=politic - отбор по краткому имени секции
- mytopics=1 - отбор только своих тем
возвращаемое значение:массив в формате json. каждый элемент массива соответствует теме форума. порядок элементов в массиве соответствует порядку тем. поля элемента массива: - id - идентификатор темы, число;
- forum - название раздела форума, строка;
- sect1 - краткое наименование секции (если есть), строка;
- sect2 - код секции (если есть);
- closed - 1, если тема закрыта;
- down - 1, если тема утоплена;
- text - заголовок темы, строка;
- user0 - ник создателя ветки, строка;
- user - ник последнего ответившего, строка;
- utime - время последнего ответа в формате unixtime, число;
- answ - число сообщений в ветке.
/ajax_gettopic.php - информация о ветке
параметры:
- id - идентификатор (topic_id) темы (!)
- callback - если указано, то ответ заворачивается в вызов функции, имя которой передано в параметре (реализация JSONP).
возвращаемое значение:структура в формате json.
// id - topic_id
// text - заголовок
// forum - одно из {'1c','it','life','moder'}
// section - секция ветки
// created - дата/время создания ветки
// user_id - user_id автора ветки
// user_name - ник автора ветки
// updated - дата/время обновления ветки
// updated_name - ник обновившего ветки
// answers_count - количество ответов
// down - 1 если ветка утоплена
// closed - 1 если ветка закрыта
// deleted - 1 если ветка удалена
// is_voting - 1 если голосование
// voting - массив вариантов голосования
// select - вариант ответа
// result - количество голосов
/ajax_topic.php - список сообщений темы.параметры:- id - идентификатор (topic_id) темы (!)
- from - с какого сообщения. если не указан, то с первого
- to - до какого сообщения. если не указан, то from+10
- callback - если указано, то ответ заворачивается в вызов функции, имя которой передано в параметре (реализация JSONP).
возвращаемое значение:массив в формате json. каждый элемент массива соответствует сообщению темы форума. порядок элементов в массиве соответствует порядку сообщений. поля элемента массива:- id - идентификатор сообщения;
- n - номер сообщения;
- text - текст сообщения;
- user - ник пользователя.
- utime - время отправки сообщения в формате unixtime.
Авторизация/ajax_login.php - авторизация пользователя.параметры: - username - логин (ник) пользователя (!);
- password - пароль пользователя (!);
- callback - если указано, то ответ заворачивается в вызов функции, имя которой передано в параметре (реализация JSONP);
возвращаемое значение:хеш-массив (структура) в формате json. поля структуры:- userid - идентификатор пользователя или 0, число
- error - описание ошибки авторизации или пустая строка
|