请教一下各位，写 api 的时候，使用 put 和 patch 方法 ，怎么处理可选参数 ？

[maemo]

比如有一个 model：

pet {
  name, 
  category,
  tags,  (optional)
}

tag 是可选的，当我用 post 创建的时候，可以不传 tag 这个参数，默认为空。但是当我用 put 更新实体的时候，我有点疑惑了。

根据定义，put 可以用来更新资源，并且包含整个实体的信息。那么是否每次调用 put 的时候都要把所有的参数都带上，包括可选的参数 ？那么我在方法中就要判断每个参数是否都传递了，而在 post 方法中我就不需要这一步了，似乎有点麻烦。

如果想只更新某一部分信息，用 patch 方法，不管是否是可选参数。

我看 swagger 上的例子，put 方法标明了哪些是可选参数，http://petstore.swagger.io/#/pet/updatePet ，那么这似乎和 patch 有点相似了，只更新部分信息，可能是我理解的不太清楚。

不知大家在写 api 的时候是怎么处理这样的情况的，麻烦指点一下。

[kaneg]

put 的时候如果不传可选参数，则使用默认值，比如空值，而 patch 的时候不传的参数都保持原值。

[maemo]

@kaneg #1 如果使用默认值，那我在 put 的 handler 中就需要判断哪些参数传了，哪些参数没有传。对于没有传的参数，我需要从 obj 中获取，再赋值，最后再更新整个 obj。不知我这样做是否正确。但是这样似乎和 patch 方法的 handler 有点重复了，在 patch 的 handler 中我也需要去判断传递了哪些参数。不知我理解的对不？

[WilliamYang]

@maemo 我认为你的理解是对的, 但是语义上本来是不同的, 一个代表 update, 另一个代表 partial_update

[kaneg]

@maemo 正如 williamyang 所说，这两个操作都是为了保证对 API 的调用者提供两种截然不同的语义，这种语义就是一种契约。而实现者在满足这种契约的前提下可以可以使用不同的实现。

[mornlight]

@maemo #2 为啥要从 obj 中拿出来再赋值回去，我认为这个 PUT 和 POST 处理流程一样，默认参数不传时都按接口定义的默认值处理，POST 只是多了个 new 的步骤。

[maemo]

@mornlight #5 我理解的是如果没有传参，默认为空时，直接保存，会把原来已经存在的值覆盖，所以在想要不要从 obj 中取出来

[GTim]

@kaneg 这个解释好

[maemo]

@kaneg #4 这个解释简单明了，我后来又理解了一下，不管我方法的具体实现是怎样，只要符合规范的语义就行了。我之所以有这个疑问，是我把具体的实现方法也考虑进去了。