具有不同内容类型的 REST API答案

【问题标题】：REST API with different content types具有不同内容类型的 REST API
【发布时间】：2013-02-04 02:16:25
【问题描述】：

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

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

【问题讨论】：

【解决方案1】：

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

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

【讨论】：