api - 具有不同内容类型的 REST API

Question

我有一个 REST API 端点来修改资源，即 PUT。该资源可以有一个与之关联的文件，因此我支持两种不同的内容类型:application/json 和 multipart/form-data。第一个是在不关联文件的情况下修改资源，第二个是当我想将文件与资源关联时。

代表这一点的最佳方式是什么？我应该为两种不同的内容类型使用相同的 URI，例如更新/:资源ID？我应该有两个不同的端点，例如update/:resourceId 和 updateWithResource/:resourceId?或者这完全是错误的方式，我应该做其他事情吗？

Answer 1

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

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