REST API с различными типами контента

Question

У меня есть конечная точка REST API для изменения ресурса i.e. PUT. У ресурса может быть связанный с ним файл, поэтому я поддерживаю два разных типа контента: application/json и multipart/form-data. Первый - для изменения ресурса без привязки файла, а второй для того, когда я хочу связать файл с ресурсом.

Каков наилучший способ представить это? Должен ли я использовать один и тот же URI для двух разных типов контента, например. обновление /: RESOURCEID? Должен ли я иметь две разные конечные точки, например. update /: resourceId и updateWithResource /: resourceId? Или это совсем не тот путь, и я должен сделать что-то еще?

Answer 1

Типы контента - это просто разные представления одного и того же источника. Таким образом, пока они представляют одно и то же, они могут и должны использовать один и тот же URI.

URI не должен влиять на тип контента, это не RESTish. Согласовать представление только с заголовком содержимого.