Mail messages

Получить письмо целиком

Недоступное и отсутствующее письмо одинаково возвращают 404. HTML письма приходит таким, каким его прислал отправитель: обезвреживание живёт на отдаче, а не в хранимой копии.

get/api/v1/mail/messages/{id}

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/mail/messages/{id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://erp.akeda.ru/oauth2/authorize, token URL https://erp.akeda.ru/oauth2/token, scopes: akeda:delegate)

Response

Письмо вместе с конвертом и вложениями

idstring uuid required
account_idstring uuid required
folder_idstring uuid required
thread_idstring uuid required
message_refstring required

Message-ID без угловых скобок; письму без него присваивается наш

in_reply_tostring

Заголовок In-Reply-To

referencesstring

Заголовок References целиком

subjectstring required
from_addressstring required
from_namestring required
snippetstring required

Короткий пересказ письма для списка

body_textstring
body_htmlstring
size_bytesinteger required
direction'inbound' | 'outbound' required
is_readboolean required
is_flaggedboolean required
is_answeredboolean required
is_draftboolean required
has_attachmentsboolean required
spam_verdict'unknown' | 'spam' | 'ham' required

Вердикт по спаму; unknown — состояние по умолчанию. Вердикт справочный и с папкой не связан: письмо во «Входящих» может нести spam от провайдера (флаг $Junk на сервере почты), а папку «Спам» задаёт только перенос. Решение человека (spam_source=user) сильнее флага сервера и правил.

spam_source'provider' | 'rule' | 'user' | 'agent'

Кто вынес вердикт. Решение человека сильнее флага сервера и правил

spam_reasonstring
bounce_of_idstring uuid
sent_atstring date-time nullable required
received_atstring date-time required
created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.