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

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

action = get_posts

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

topic_id – id темы

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

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

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

only_first – Получить только первый пост в теме. Принимает значение true или false. Если параметр равен true будет получен только первый пост в теме. FIXME «first_only» ?

get_attach – Получать информацию о прикрепленных файлах. Принимает значение true или false. Если true – получать информацию о прикрепленных файлах. FIXME «get_attachment» ?

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

<post>
 
<id>793188<./id>
 
<edit_time>1203112649</edit_time>
 
<date>1203112649</date>
 
<is_first_post>1</is_first_post>
 
<icon_id>0</icon_id>
 
<has_mod_comment>0<has_mod_comment>
 
<use_sig>0</use_sig>
 
<append_edit_time>0</append_edit_time >
 
<edit_name></edit_name>
 
<queued>0</queued>
 
<author>
 
<id>1</id>
 
<name>admin</name>
 
</author>
 
<body>&lt;xml klklfdf&gt;</body>
 
<attach>
 
<id>post-8-1207673401.ibf</id>
 
<num_downloads>0</num_downloads>
 
<type>application/zip</type>
 
<size>86.26</size>
 
<file>xfr.zip</file>
 
</attach>
 
</post>

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

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

id – id поста

edit_time – Дата последнего изменения поста в UNIX формате

date - Дата создания поста в UNIX формате

first - если равен 1 – это первый пост в темы

icon_id – id иконки поста

has_modcommentary - если равен 1 – пост содержит комментарии модератора

use_sig – если равен 1 – пост не может редактироваться пользователем

append_edit – дата “слияния” постов в UNIX формате

edit_name – имя пользователя, последним редактировавшим пост.

queued1 - пост на премодерации.

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

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

name - имя автора поста

body – Содержание поста

attach – прикрепленный файл

id – id файла

num_downloads – кол-во скачиваний

type – MIME тип прикрепленного файла

size – размер файла в килобайтах

file – имя файла.

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

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

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

ERROR_TOPIC_NOT_EXISTS – темы с указанным id не существует

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

 
projects/xforumreader/getting_topic_posts_list.txt · Последнее изменение: d.m.Y H:i — romtek
 
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki