如何设计多类相似展示数据的REST API端点结构？

针对你提到的四类相似数据（视频、文章、帖子等）获取最新10条的路由设计，两种方案各有优劣，具体选择可以结合业务需求判断：

一、单独路由方案（如/videos/latest、/articles/latest） #

• 优势：
  • 路由语义清晰，前端调用时一目了然，不用额外记忆参数规则，降低出错概率
  • 后续扩展灵活，如果某类数据需要特殊处理（比如视频返回播放地址、文章返回阅读量统计），直接修改对应路由即可，不会影响其他类型的接口逻辑
  • 权限控制更精准，比如可以单独限制视频接口的访问权限，无需在统一接口里做复杂的分支判断
• 劣势：
  • 初期会存在一定代码冗余，如果四类数据的业务逻辑完全一致，重复代码会增加维护成本

二、统一参数路由方案（如/content/latest?type=video） #

• 优势：
  • 代码复用性高，只需要编写一套核心逻辑，通过type参数区分数据类型，大幅减少重复代码
  • 新增同类数据类型时成本低，不需要新增路由，只需要在后端添加对应的类型判断即可
• 劣势：
  • 路由语义不够直观，前端需要准确传递type参数的合法值（比如是video还是videos），容易出现参数错误
  • 若后续某类数据需要特殊逻辑，只能在统一接口里添加大量分支判断，会导致代码逐渐臃肿，维护难度上升
  • 权限控制需要在接口内部处理，不如单独路由的权限配置清晰

三、最终建议 #

• 如果四类数据当前逻辑完全一致，且短期内没有独立扩展需求，优先选择统一参数路由，节省初期开发时间
• 如果每类数据未来大概率会有独立的业务规则、权限要求或字段差异，建议使用单独路由，为后续业务扩展留足空间
• 折中方案：可以先封装统一的底层处理逻辑（比如数据库查询、分页逻辑），再为每类数据创建单独路由，在路由层调用公共逻辑并补充各自的特殊处理，兼顾复用性和扩展性

内容的提问来源于stack exchange，提问作者Charles Pettis