Mail messages

Сохранить вложение письма в «Файлы»

Changed on

Копия вложения письма в выбранную папку хранилища кабинета (ERP-2633) без скачивания на компьютер: почта отдаёт байты с видимостью ящиков человека (файл, который ещё не открывали, сначала забирается с почтового сервера и проверяется антивирусом), «Файлы» кладут его своим путём загрузки — с правом на запись в папку, квотой кабинета и свободным именем: занятое получает « (1)», прежний файл не затирается. name — имя файла в папке, по умолчанию имя вложения. Заражённое вложение не сохраняется — 403 mail.attachment_infected, ещё проверяемое — 409 mail.attachment_pending; нет права на папку — 403 files.forbidden, место кончилось — 507 files.quota_exceeded. Кабинетный API-ключ в хранилище не пускается — 403 files.service_principal_denied, как у дверей «Файлов».

post/api/v1/mail/attachments/{id}/save-to-files

Request

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

Request body

folder_idstring uuid required
namestring

Имя файла в папке; пусто — имя вложения

Response

Файл в папке хранилища

idstring uuid required
folder_idstring uuid required
root_idstring uuid required
namestring required
external_urlstring uri

HTTP(S)-адрес внешнего ярлыка; отсутствует у обычных файлов

extensionstring required
mime_typestring required
size_bytesinteger required
version_nointeger required
version_idstring uuid
owner_idinteger required
created_byinteger required
updated_byinteger
trashed_atstring date-time
created_atstring date-time required
updated_atstring date-time required
scan_status'pending' | 'scanning' | 'clean' | 'infected' | 'skipped' | 'error' required

skipped — содержимое крупнее порога проверки: оно выдаётся, но честно помечено непроверенным

scan_verdictstring
preview_status'pending' | 'processing' | 'ready' | 'unsupported' | 'error' required
has_thumbnailboolean required
is_favoriteboolean required
folder_namestring

Changes