【发布时间】:2011-11-20 21:20:27
【问题描述】:
是否有 REST 最佳实践来获取不同语言的资源。目前,我们有
www.mysite.com/books?locale=en
我知道我们可以使用接受语言标头,但这样做对我们来说更好吗
www.mysite.com/books/en or www.mysite.com/books.en
还是没关系?
【问题讨论】:
标签: rest restful-url
是否有 REST 最佳实践来获取不同语言的资源。目前,我们有
www.mysite.com/books?locale=en
我知道我们可以使用接受语言标头,但这样做对我们来说更好吗
www.mysite.com/books/en or www.mysite.com/books.en
还是没关系?
【问题讨论】:
标签: rest restful-url
如果您试图让您的服务器返回相同书籍的不同翻译或本地化版本(换句话说,从 RESTful 角度来看,相同的资源),请使用 Accept-Language,因为资源相同但表示形式相同根据客户的需求而有所不同。
但是,如果您尝试根据客户的语言环境返回完全不同的书籍(例如,如果您知道用户在法国,则返回用法语编写的书籍),那么 URI 应该是不同的因为会返回不同的资源。在这一点上,您谈论的更多是查询请求。对于它的价值,/books/en 方法听起来很合理。另一种方法是将语言环境或语言作为资源参数添加到 GET 作为/books?lang=en。
【讨论】:
我认为最好的方法是实现以下方式:
换句话说,您可以接受两种来源的语言。实施将如下:
通过这种方法,您可以确保 a) 路径路由与语言无关,并且您的系统将与路径一致地工作; b) 语言处理/协商将与您的脚本完全分离。您可以在脚本中使用语言信息,甚至不知道来源和请求方式。
【讨论】:
我同意answer中manuel-aldana对问题RESTful URL: where should I put locale? example.com/en/page vs example.com/page?locale=en的评论
首先检查参数(例如 locale=en )以允许客户端明确指定语言并回退到Accept-Language
【讨论】: