Содержание

Получение списка тем в форуме

Запрос клиента

action = get_topics

forum_id – id форума, для которого нужно получить список тем

date_start – дата, начиная с которой нужно получить темы. Дата указывается в UNIX формате. Кроме того, может принимать следующие значения: day, week, month; при этом значение параметра date_stop игнорируется.

date_stop – дата, заканчивая которой нужно получить темы. Дата указывается в UNIX формате.

ignore_starter - Не получать темы созданные пользователями с указанными id. Id пользователей перечисляются через запятую.

receive_solved – Получать темы, у которых стоит 'вопрос решен'. Принимает значение true или false. Если параметр равен false темы с флагом 'вопрос решен' не будут получены.

receive_closed - Получать закрытые темы. Принимает значение true или false. Если параметр равен false закрытые темы не будут получены (доступно только модераторам/администраторам).

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

<topic>
<id>104998</id>
<forum_id>16</forum_id>
<hidden>0</hidden>
<solved>0</solved>
<deleted>0</deleted>
<pinned>0</pinned>
<club>0</club>
<start_date>1203108615</start_date>
<state>closed</state>
<poll_state>0</poll_state>
<close_description>Причина закрытия темы</close_description>
<author>
<id>25403</id>
<name>user</name>
</author>
<title>Тест</title>
<has_poll>1</has_poll>
<post_count>2387</post_count>
<last_post>
	<author>
		<id>24898</id>
		<name>user</name>
	</author>
	<date>19372038</date>
</last_post>
<description/>
<approved>1</approved>
</topic>

Описания элементов

topic – информация о теме

id – id темы

forum_id – id форума

hidden – если равен 1 – тема скрыта

solved - если равен 1 – “Вопрос решен”.

deleted - если равен 1 – тема удалена

pinned - если равен 1 – тема прикреплена

club - если равен 1 – тема с ограниченной видимостью (клубная тема)

start_date – дата создания темы в формате UNIX.

state – состояние темы: open – открыта, closed – закрыта, link – тема перемещена

poll_state – голосование. Если пустое значение – тема без голосования, если open, closed – тема с голосованием и параметр содержит состояние голосования.

name – содержит имя категории

close_descr – если тема была закрыта, то содержит причину закрытия темы. Иначе этот элемент отсутствует.

author – информация об авторе темы, содержит следующие атрибуты:

id - id автора темы

name - имя автора темы

has_poll – если равен 1 – тема с голосованием

post_count – кол-во постов в теме

last_post – информация о последнем посте

FIXME (дубликат) author – информация об авторе последнего поста

FIXME (дубликат) id – id автора

FIXME (дубликат) name – имя автора

date – дата поста

title – Название темы

description – краткое описание

approved – Если 1 - тема одобрена, если 0 – тема требует подтверждения модератора; только модераторы или администраторы могут получать такие темы.

Описание ошибок

ERROR_NO_FORUM_ID - параметр “forum_id” не передан в POST-запросе

ERROR_DATE_INTERVAL_OUT_OF_RANGE - промежуток указанных дат больше, чем позволено конфигурацией сервера