当属性不存在时，在REST JSON API上POST / PUT

Question

我们正在构建公共RESTful JSON API，并试图找出当指定属性不存在时POST / PUT请求的最佳实践。 我们应该抛出HTTP错误，哪一个或只是跳过它并应用所有其他属性？

{
    "name" : "Test",
    "property_doesnt_exist" : "that's sad"
}

Answer 1

HTTP 422：不可处理的实体

422（不可处理实体）状态代码表示服务器理解请求实体的内容类型（因此415（不支持的媒体类型）状态代码是不合适的），并且请求实体的语法是正确的（因此是400（错误请求） ）状态代码不合适）但无法处理包含的指令。 例如，如果XML请求主体包含格式正确（即语法正确）但语义错误的XML指令，则可能发生此错误情况。 RFC4918

如果消息还包含无效属性，则通常的做法是不添加有效的消息属性。

Answer 2

服务器的一个常见规则是慷慨接受你所接受的内容并严格遵守你所生产的内容。

我更愿意接受这样的输入并尽可能多地获取它。 输入的任何未知属性都将被忽略。

Answer 3

在回答这个问题时，你也必须考虑版本控制。 您是否支持发送的参数少于预期的旧客户端 - 可以使用合适的默认值。 或者，您是否有多个服务器实现，以便较新的客户端为较旧的服务器实现发送过多的参数？ 如果其中一个答案是肯定的，那么你必须小心拒绝输入。