前端对后端接口的疑问

Question

最近换的一份新工作，在和公司后端小哥哥配合上出现一些问题，想问一下各路大神！
在前后端联调接口的时候，会遇到，比如说查询列表和查询单条数据详情用的是同一个接口？公司的小哥哥说是接口的复用性，还想具体了解下这种接口的优缺点

Answer 1

• 问题一：返回的字段一样多吗？

  • 一样多，那么一个文章列表，他会返回大量的文章内容。会出现流量多、速度慢
  • 不一样，那么前端使用的时候很迷茫，什么时候会有什么字段呢？不宜排查问题

• 问题二：你说的同一个接口是指 URL 一模一样？还是说的 RESTful API 方案？

  • GET /ticket 获取 ticket 列表
  • GET /ticket/:id 查看某个具体的 ticket
  • POST /ticket 新建一个 ticket
  • PUT /ticket/:id 更新 id 为 12 的 ticket
  • DELETE /ticket/:id 删除 id 为 12 的 ticekt

正常场景，应该都差不多。无非就是一个http请求，改改参数嘛

Answer 2

接口的复用性也不是这样。
优点： 后端可以写少一个接口文档
缺点： 列表和详情的结构体不一样，详情比列表字段更多，sql语句也不一样 而且列表应该还要作分页处理
没有合在一起的必要

Answer 3

正常是看数据的复用性，前端展示页面用到的数据如果没必要那么多，最好不要复用一个接口，请求数据量大耗时耗力，可以和后端商量下，请求参数设置多个，根据请求参数设置返回数据