·

restful 规范还是需要的,几年开发经验,我从最开始遵守 restful 到弃用,全用 post/get,再到现在严格规范 restful,经历过很多接口开发,几个好处:

  • 减少文档:接口可以猜出来,开发效率高,规范化
  • 代码生成:可以利用现有代码生成工具,生成测试用例、模板等等
  • 监控方便:需要路由鉴权、安全审计的时候方便
  • 工具配合:很多网络插件配合状态码可以揪出很多异常行为(攻击源)

只用 post/get 开发更快?根据我的经验不会,反而会更乱,人多的时候不规范,有时候不看源码你都不知道接口在哪,返回什么字段(因为文档也会很乱)。

http method 表达能力不够?一开始我也是这么觉得的,但是接口写多了,其实就是自己抽象能力不足的问题,可以参考 google / Microsoft 的 restful 规范,你遇到的问题里面都可以找到。

Google API design guide

microsoft api guidelines