我正在制作一个21点休息服务,目前有4个GET端点:
/hit
/stand
/double down
/surrender
我也可以只做一个POST/PATCH端点,使用dto发送移动,或者我应该保留使用这四个uri ?
哪个选项会更宁静/更好?
提前感谢。
使用一个端点。所有这些操作/命令都使用同一组数据。
我建议使用一个REST端点,它接受RequestBody并返回链接作为响应的一部分。
- 当链接作为响应的一部分返回时,我们正在实现HATEOS,它增加了API的rest性。(达到Richardson成熟度模型第3级)
- 客户端可以理解接收到的链接作为响应的一部分,并可以采取相应的下一步行动。这可以防止客户端为了整体完成一个任务而进行多个REST调用。
- (个人开发经验)如果我们维护太多的REST api,特别是GET api,代码维护会增加时间。此外,它本质上是不可扩展的,也就是说,如果出现了新的需求,而我们没有DTO,那么我们就必须定义多个新的端点。另一方面,如果我们使用DTO的端点数量较少,我们可以灵活地增强DTO本身,使其具有可以帮助我们实现新功能的属性。
进一步阅读,这是一篇关于REST的好文章。