Mail messages

Временный адрес вложения письма

Подписанный адрес вложения на 15 минут: байты идут прямо из хранилища, без заголовка авторизации — так забирает файл агент по MCP. Вложение, которое ещё не открывали, сначала забирается с почтового сервера и проверяется антивирусом. direct=false — хранилище подписывать не умеет, адрес ведёт на mailGetAttachmentContent и требует авторизации. scan_status=skipped честно говорит, что файл антивирус не проверял. Заражённый файл адреса не получает — 403 mail.attachment_infected, ещё проверяемый — 409 mail.attachment_pending.

get/api/v1/mail/attachments/{id}/download-session

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/mail/attachments/{id}/download-session
  • 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

Временный адрес

urlstring required
directboolean required

true — подписанный адрес хранилища, без заголовка авторизации; false — адрес этого API, с авторизацией

expires_atstring date-time

Срок подписанного адреса; у адреса API его нет

namestring required
mime_typestring required
size_bytesinteger required
scan_status'pending' | 'clean' | 'infected' | 'skipped' required

Состояние антивирусной проверки файла. pending существует потому, что письмо сохраняется целиком, а проверка идёт потоком: видеть письмо можно сразу, скачать вложение — только после вердикта.

Changes

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