Restful 接口，给某个对象的单个字段赋值，如何设计

資深大佬 : hackingwu 0

有一个接口的功能是”确认“某个对象。我的 Restful API 设计成 PUT /obj/{id}/is_confirmed/{is_confirmed} String id, boolean is_confirmed 这个接口符合 Restful 规范吗？类似的 URL 你们怎么设计？

大佬有話說 (7)

資深大佬 : chinvo

用 PATCH

PUT 就是覆盖

而一般来说接口要避免路径过长
資深大佬 : chinvo

可以参考这个

https://cloud.google.com/apis/design
資深大佬 : chendy

PUT /obj/{id}/_confirm 自定义一个动词就行了
資深大佬 : Oktfolio

Patch 修改部分值可以使用 Json Patch 。

至于上述这种接口，可以单独开一个，没必要完全遵照 REST 来定义接口，好用直观就行。

接口最好使用 “-” 而不是 “_” 噢。
資深大佬 : chinvo

@chendy #3 自定义动词各家实现不太一样, Google 家为了避免和次级资源名冲突(或造成误解), 用的是 PUT /obj/{id}:confirm 这种形式
資深大佬 : rbut

@Oktfolio 为什么是最好使用”-“呢
資深大佬 : wizardoz

不符合，用 PATCH 方法就行

PATCH /obj/{id}/

{
“is_confirmed”: true
}