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

Question

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

表示这一点的最佳方式是什么？我是否应该对两种不同的内容类型使用相同的 URI，例如 update/:resourceId？我是否应该有两个不同的端点，例如 update/:resourceId 和 updateWithResource/:resourceId？或者这完全是错误的方式，我应该做点别的？

Answer 1

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

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