具有不同内容类型的REST API

Question

我有一个REST API端点来修改资源，即PUT。资源可以有一个与之关联的文件，所以我支持两种不同的内容类型：application/json和multipart/form-data。第一个用于修改资源而不关联文件，第二个用于当我想将文件与资源关联时。

代表这个的最好方法是什么？我是否应该为两种不同的内容类型使用相同的URI更新/：RESOURCEID？我应该有两个不同的终点，例如更新/：resourceId和updateWithResource /：resourceId？或者，这是完全错误的方式去，我应该做别的？

Answer 1

内容类型只是同一资源的不同表示。所以只要它们代表相同的事物，他们就可以并且应该共享相同的URI。

URI不应该影响内容类型，这不是RESTish。只与内容类型标题协商表示。