rest - 如何安排我的多语言 REST API？

Question

我刚刚开始构建一个多语言 REST API，并不确定是否有任何关于我应该如何正确集成多语言的约定。

以下是我提出的替代方案列表，不知道哪个最有意义。

选项 1:
URI 中的语言变量:http://myapi.com/en/users/john
选项 2:
仅返回翻译客户端的错误代码:GET http://myapi.com/users/john => HTTP 404 {status: false, error_code: "321"}
选项 3:
以所有可用语言返回:GET http://myapi.com/users/john => {status: false, error_en: "User not found", error_sv: "Anvandaren finns inte"}

Answer 1

对于 content negotiation至于协商表示的自然语言，HTTP 提供了 request header Accept-Language :

Accept-Language: da, en-gb;q=0.8, en;q=0.7

如果可能，服务器会回复此请求 response header Content-Language :

Content-Language: da

只有当资源是不同语言的不同资源时，语言才应该是 URI 的一部分。如果不是，则应使用内容协商。