0

我们正在构建一个 RESTful API,它主要返回 JSON 格式的响应。大多数资源还将有条件地将响应包装为 JSONP 格式,具体取决于查询参数“回调”是否存在。

我的问题是,“我们是否应该以 '.js' 结尾我们的端点名称,因为它们是 JSON?”

通常,Web 服务不以文件扩展名结尾。但是,如果我们将 URL 视为静态资源(通过动态生成)而不是服务,那么给端点文件扩展名对我来说是有意义的。

这样做会改变什么吗?它以任何方式有益还是有害?

提前致谢。

4

1 回答 1

3

这可能很大程度上取决于个人喜好,但我不建议这样做,尤其是如果您有面向公众的 API。

出于某种原因,如果我看到一个不是众所周知的动态生成内容的文件扩展名(如.php.jsp.cgi),我倾向于认为它是一个静态文件,所以我可能错误地认为我可以缓存它或处理它就像它的静态内容一样。一组好的文档可能会让事情变得清晰,但给它一个.js扩展可能只会让其他开发人员感到困惑。

此外,@user2864740 对标准和其他事情发表了很好的评论。我希望我能更多地了解这些答案,所以请阅读他的贡献。

于 2013-10-14T20:02:49.097 回答