Запись опубликована:11.10.2022
Post category:Беседы
Запись изменена:03.11.2022

GET api/2.0/mail/conversations

Для этой функции требуется аутентификация

Описание
Возвращает диалоги с указанными в запросе параметрами, если с даты последней проверки были изменения.

Параметры

Название	Описание	Тип	Пример
folder sent in url	Тип папки: 1 — входящие, 2 — отправленные, 3 — черновики, 4 — корзина, 5 — спам необязательно	номер	1234
unread sent in url	Статус разговора: непрочитанные (true), прочитанные (false) или все (null) сообщения необязательно	логический	true
attachments sent in url	Определяет, есть ли в разговоре вложения или нет: с вложениями (true), без вложений (false) или все сообщения (null) необязательно	логический	true
period_from sent in url	Дата начала периода поиска необязательно	номер	1234
period_to sent in url	Дата окончания периода поиска необязательно	номер	1234
important sent in url	Важный разговор или нет необязательно	логический	true
from_address sent in url	Почтовый адрес, с которого пришло письмо необязательно	строковый	текст
to_address sent in url	Адрес электронной почты, на который пришло письмо необязательно	строковый	текст
mailbox_id sent in url	Идентификатор почтового ящика получателя необязательно	номер	1234
tags sent in url	Идентификаторы тегов, связанных с целевым разговором необязательно	Collection of numbers collection	1234
search sent in url	Текст для поиска в теле и теме беседы необязательно	строковый	текст
page_size sent in url	Количество разговоров на странице необязательно	номер	1234
sortorder sent in url	Порядок сортировки по дате: «по возрастанию» — восходящий, «по убыванию» — нисходящий	строковый	текст
from_date sent in url	Дата, с которой был выполнен поиск разговора необязательно	дата и время	Roundtrip format: 2008-04-10T06-30-00.000Z
from_message sent in url	Сообщение, из которого выполняется поиск разговора необязательно	номер	1234
with_calendar sent in url	У разговора есть календарь или нет необязательно	логический	true
user_folder_id sent in url	Идентификатор папки пользователя необязательно	номер	1234
prev_flag sent in url	Направление сортировки списка разговоров (предыдущий или следующий) необязательно	логический	true

Пример

GET api/2.0/mail/conversations?from_address=some+text&to_address=some+text&tags=%5b1234%5d&search=some+text&sortorder=some+text&from_date=2008-04-10T06-30-00.000Z
Host: yourportal.r7-office.ru
Content-Type: application/json
Accept: application/json

Возвращает
Список отфильтрованных разговоров