Грузовладелец в любой момент времени может загружать вложения в
- запросы: с помощью метода POST /api/v1/tender/{id}/upload (где id - это идентификатор запроса)
/api/docs/ui/index#!/Attachment/tender_upload_post
- пакетные запросы: с помощью метода POST /api/v1/tender/batch/{id}/upload (где id - это идентификатор пакетного запроса)
/api/docs/ui/index#!/Attachment/tender_upload_post
В зависимости от выбранного Типа доступа, вложение будет доступно либо всем участникам торгов либо только своим сотрудникам.
Перевозчик может загрузить вложение в заявку только после победы в торгах.
Для этого, он может воспользоваться методом POST /api/v1/request/{id}/upload (где id - это идентификатор заявки)
/api/docs/ui/index#!/Attachment/request_upload_post
В зависимости от выбранного Типа доступа, вложение будет доступно либо грузовладельцу либо только своим сотрудникам.
Параметры вложения
Для загрузки вложения понадобятся:
- id - идентификатор запроса/заявки
- Type - типа документа
- File - содержимое файла
- Прочие необязательные параметры, описывающие документ во вложении (по аналогии с полями интерфейса пользователя)
После загрузки, методы возвращают идентификатор вложения и постоянную ссылку на его скачивание:
Вызов методов загрузки
Методы загрузки вложения принимают параметры только в формате multipart/form-data.
Обратите внимание
Интерактивная «песочница» не умеем самостоятельно формировать тело запроса в формате multipart/form-data (хотя сформированное тело в виде текста отправить может).
В связи с этим рекомендуем тестировать данную функциональность при помощи сторонних инструментов, например Postman или классических консольных утилит cURL, GNU Wget (перед использования последних, стоит ознакомиться со статьей Особенности использования API с помощью консольных утилит).
Примеры работы с методами загрузки вы можете найти в статье Как загрузить вложение в запрос/заявку.