接口设计合理性讨论

[sseven]

编辑保存的接口入参如下

{
  id: 1,
  name: '',
  age: 1,
  childTable: [{ id: 1, cardNo: '', type: 1, del: 0 }],
}

关于 childTable 中的数据如何传？

方式一

• 无 id ，表示新增
• 有 id ，表示编辑
• 不传的表示删除了
  • 即，获取详情 childTable 返回了三条，如果删了一条，删的那条不用传了

方式二

• 无 id ，表示新增
• 有 id ，表示编辑
• 传 del=1,表示删除
  • 即，获取详情 childTable 返的数据中，如有有被删的，删除那条打 del 标记

不同点在于删除的处理

• 方式一需要后台查库比较哪些数据被删了
• 方式二需要前台做逻辑，标记哪些数据被删了

需要传 del 吗？哪种设计更合理？

[debuggerx]

我的话宁愿用 POST/PUT/DELETE 方法来区分……

[wpzz]

拆成三个接口，能监控到用户不同的行为。

而且后端一个 controller 三个不同 service 不合理。

[yinmin]

写 3 个接口，通过 url 区分，都用 post method ，别 restful 过不了等保

[luermao]

方式二

[wei2629]

有的情况是无法拆分。不是一个操作就保存，而是多个操作后一次性保存。 可能考虑读取数据然后比对。