• Post category:Беседы
  • Запись изменена:03.11.2022

GET api/2.0/mail/conversation/{id}/{direction}

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

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

Параметры

Название Описание Тип Пример
id

sent in url
Идентификатор заголовка сообщения текущего разговора номер 1234
direction

sent in url
Определяет, нужен ли предыдущий или следующий разговор: «prev» для предыдущего, «next» для следующего строковый текст
folder

sent in url
Тип папки: 1 — входящие, 2 — отправленные, 5 — спам

необязательно
номер 1234
unread

sent in url
Статус сообщения: непрочитанные (true), прочитанные (false) или все (null) сообщения

необязательно
логический true
attachments

sent in url
Определяет, имеет ли сообщение вложения или нет: с вложениями (true), без вложений (false) или все (null) сообщениеe

необязательно

логический 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
Порядок сортировки по дате: «по возрастанию» — восходящий, «по убыванию» — нисходящий строковый текст
with_calendar

sent in url
Сообщение имеет календарь или нет

необязательно
логический true
user_folder_id

sent in url
Идентификатор папки пользователя

необязательно
номер 1234
Пример
GET api/2.0/mail/conversation/1234/some+text?from_address=some+text&to_address=some+text&tags=%5b1234%5d&search=some+text&sortorder=some+text
Host: yourportal.r7-office.ru
Content-Type: application/json
Accept: application/json
Возвращает
Идентификатор заголовка сообщения предыдущего или следующего разговора