获取多个实体时对单个实体中的数据损坏的 RESTful 响应

Question

当实体之一出现数据损坏错误时，我目前在为获取多个实体的 REST API 选择最合适的响应时面临两难境地。假设我有一个如下所示的 REST API：

GET /employees?department=&manager=

返回员工列表，可能应用了一些过滤。

从上游（数据库或其他 Web 服务等）获取数据时，我发现符合条件的一名员工的数据已损坏。例如，数据无法解析或不满足该数据实体所必需的某些先决条件。

什么是最合适的（从 API 的角度）对此的 RESTful 响应？我应该继续处理所有其他员工并简单地忽略错误并在响应中省略它，还是使用500 Internal Server Error 出错，或者在返回其他“好”员工的同时将错误包含在单独的字段中？

我知道这有点基于意见，但我们将不胜感激。

Answer 1

如果你想返回一个错误，这（对我来说）是一个服务器错误，我认为500 确实是最合适的错误。

您是否要返回错误或带有警告的不完整列表取决于您的应用程序要求它执行的操作。