api - 处理 API 的多个响应代码的好方法是什么？

Question

考虑调用 REST API:

POST /employees 
[{ "name":"joe", "job":"dev",
 { "name":"bob" }]

将为每个数组元素创建一个员工。但是job是必填字段，所以第二个元素无效，无法创建employee。

对此有什么好的回应？ 201 还是 422？

我看到了207，不过好像需要XML响应，而且API没有使用XML。只为这种情况返回 XML 似乎很奇怪。

对于这个特定的用例，我认为所有有效元素都将用于创建资源。但我不确定什么是好的回应。

Answer 1

我们将 400 用于任何字段验证错误(包括缺少必填字段)，无论是针对单个资源还是整个集合。