REST API中的Raw vs Lookup值

Question

我们正在项目中实施REST API，我们无法就响应数据达成共识。

所以我们有一些“代码”实体。这些实体包含字段代码（简单的字母数字标识符）和此代码的描述（一些描述文本）。在当前客户端应用程序的某些页面上，我们需要根据用户设置显示查找值（例如代码 - 描述或描述 - 代码）。 REST API应该返回配置值还是只返回原始代码值？我的观点是代表是客户的责任。

您怎么看？

Answer 1

我会返回代码和说明。如果客户端不想使用服务器提供的描述，他们可以简单地忽略它。

如果您需要国际化，请支持Accept-Language HTTP标头，以根据所需语言提供说明。