Какую команду REST использовать для получения данных из полезной нагрузки, управления ими и возврата результата?

Я не хочу хранить какие-либо изображения или возвращать сохраненные изображения. Я просто хочу манипулировать изображением из запроса и вернуть его.

Сегодня у HTTP нет хорошего ответа на этот вопрос.

HTTP — это прикладной протокол, областью применения которого является передача документов по сети — Webber, 2011

Семантика HTTP-сервера очень похожа на семантику хранилища документов — мы запрашиваем копии документов (GET) или просим отредактировать копию документа на сервере (POST, PUT, PATCH, DELETE... .).

Из зарегистрированных HTTP-методов нет подходящего для эффективного запроса только для чтения с полезной нагрузкой.

Что оставляет вам один из следующих вариантов

• Вы можете использовать стандартный метод нестандартным способом и нести ответственность за последствия
• Вы можете использовать нестандартный метод
• Вы можете определить новый метод и зарегистрировать его, работая над процессом стандартизации и стимулируя внедрение
• Вы можете использовать ПОСТ.

POST служит многим полезным целям в HTTP, в том числе общей цели «это действие не стоит стандартизировать». -- Филдинг, 2009

У меня возникли проблемы с пониманием того, как я могу поместить изображение и другую информацию в одну полезную нагрузку (может быть, в виде байтов?)

Подумайте, как вы могли бы добиться этого во всемирной паутине.

Вероятно, у вас будет HTML-форма с элементом управления вводом (type="file"), который позволяет оператору указать, какой файл использовать, и дополнительными элементами управления вводом, которые собирают другую интересующую информацию. Описание формы может включать значения по умолчанию, предварительно загруженные в элементы управления вводом, или списки параметров и т. д. Когда пользователь отправляет форму, реализация стандартизированной обработки HTML-форм в веб-браузере применяется к входным данным, создавая HTTP-запрос POST с типом содержимого multipart/form-data.

По внешнему виду оно очень похоже на электронное письмо с одним или несколькими вложениями.

На исходном сервере полезная нагрузка распаковывается, что фактически приводит к обратному преобразованию входных данных формы в их отдельные представления.

Недостатком POST в этом контексте является то, что он не сообщает компонентам общего назначения тот факт, что ваша обработка этого запроса будет идемпотентной. Таким образом, мы не получаем «автоматически повторять запрос», когда сеть теряет сообщения.

Кроме того, компоненты общего назначения не смогут эффективно кэшировать ответ, поскольку у них нет стандартизированного метода включения полезной нагрузки запроса как части ключа кэша.

Короче говоря, POST — это лучшее, что вы можете сделать со стандартными методами.