CRM inbox

Открыть сессию загрузки файла для сообщения диалога

Файл кладётся прямо в хранилище кабинета по подписанному адресу, мимо API: так его загружают агент по MCP и клиенты с крупными файлами. Ответ называет путь байтов: post — один multipart POST на upload.url с полями upload.fields и файлом последним полем upload.file_field; parts — PUT каждой части на upload.direct_urls; api — хранилище подписывать не умеет, байты идут PUT на upload.url этого API с авторизацией. Затем crmFinishInboxUploadSession проверяет размер, контрольную сумму и антивирус и заводит загрузку для upload_ids. Потолок файла — 25 МБ. Клиенту файл уходит только через канал, у провайдера которого есть возможность files (crmListInboxProviders); иначе отправка отвечает 400 crm.inbox.files_unsupported. Диалог, назначенный другому менеджеру, отвечает 404.

post/api/v1/crm/inbox/conversations/{id}/upload-sessions

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/crm/inbox/conversations/{id}/upload-sessions
  • 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

namestring required

Имя файла с расширением

mime_typestring

Тип содержимого; по умолчанию application/octet-stream

size_bytesinteger required

Точный размер файла в байтах

sha256string

Необязательная контрольная сумма SHA-256 строчными шестнадцатеричными знаками

Response

Сессия и адрес для байтов

idstring uuid required
owner_typestring required
owner_idstring
namestring required
mime_typestring required
size_bytesinteger required
sha256string
attributesobject
status'pending' | 'processing' | 'attached' | 'failed' | 'expired' required
failure'infected' | 'size' | 'checksum' | 'storage' | 'owner' | 'aborted' | 'expired'
failure_detailstring
scan_status'pending' | 'clean' | 'infected' | 'skipped'
scan_verdictstring
published_refstring

Номер строки, заведённой по файлу; у почты — id загрузки для upload_ids

expires_atstring date-time required
created_atstring date-time required
completed_atstring date-time

Changes

No recorded changes to this operation across all 2 revisions of this API.