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

Question

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

Answer 1

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