如果Content-Type与application / json不同，则显示REST文档

Question

如果客户Content-Type不是application/json，那么显示特定REST资源的文档是否是一个好主意？我的意思是，如果开发人员试图在浏览器中获取REST资源URL，他会得到类似this的内容。

Answer 1

虽然这是开放的讨论，但在我看来这是一个坏主意。 RESTful API的全部目的是公开您的应用程序界面供其他开发人员使用。一些开发人员查看http标头以确定您的REST API的某些路由是否存在，而不管内容类型如何。如果我要求text / plain，我希望收到404 / NotFound，如果你没有它，而不是200 / OK的文档。虽然，我认为它可能对使用浏览器进行手动API测试很有用。