Список писем

API 0.16.0OpenAPIllms-full.txt

GET/v1/mailboxes/{mailbox_id}/messages

Возвращает до 40 писем, от новых UID к старым. Для следующей страницы передайте next_before как before. При next_before=null страниц больше нет. Чтение не устанавливает флаг прочтения.

Авторизация и области доступа · Ошибки и повторы

Запрос

curl -X GET 'https://adapt-mail.com/v1/mailboxes/<mailbox_id>/messages' \
  -H 'Authorization: Bearer <access_token>'

Параметры

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

integer

folderquery

string

По умолчанию: "INBOX"

qquery

string

По умолчанию: ""

maxLength: 200

beforequery

Вариант 1

integer

exclusiveMinimum: 0

Вариант 2

null

X-Customer-IDheader

Вариант 1

string

Вариант 2

null

Ответы

200 Успешный ответ

application/json

object

items

array

Элементы массива

object

uid

integer

uidvalidity

integer

folder

string

message_id

string

thread_id

string

sender

string

recipients

array

Элементы массива

object

name

string

email

string

subject

string

preview

string

flags

array

Элементы массива

string

size_bytes

integer

received_at

string

Дата и время в UTC. Если смещение отсутствует, значение также представляет UTC.

next_before

Вариант 1

integer

Вариант 2

null

uidvalidity

integer

401 Требуется вход

application/json

object

detail

Вариант 1

string

Вариант 2

object

code

string

message

string

Вариант 3

array

Элементы массива

object

403 Нет доступа

application/json

object

detail

Вариант 1

string

Вариант 2

object

code

string

message

string

Вариант 3

array

Элементы массива

object

404 Ресурс не найден

application/json

object

detail

Вариант 1

string

Вариант 2

object

code

string

message

string

Вариант 3

array

Элементы массива

object

409 Конфликт состояния

application/json

object

detail

Вариант 1

string

Вариант 2

object

code

string

message

string

Вариант 3

array

Элементы массива

object

422 Ошибка валидации

application/json

object

detail

array

Элементы массива

object

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

array

Элементы массива

Вариант 1

string

Вариант 2

integer

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

string

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

string

503 Временная недоступность

application/json

object

detail

Вариант 1

string

Вариант 2

object

code

string

message

string

Вариант 3

array

Элементы массива

object