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
Возвращает
Список отфильтрованных разговоров
Список отфильтрованных разговоров