前面我们说了，有章可循，有据可依，有正确的产品流程和规范，我们的工作才不至于产生混乱，团队的工作才能更有成效。我们经常见到，程序开发可能只用了半个月，但是接口的联调却经常需要花费半个月甚至一个月左右。

如果API的设计更规范更合理，在很大程度上能够提高联调的效率，降低沟通成本。那么什么是好的API设计？这里我们不得不提到REST API。

另外，REST API的书籍很多，但是完整完善实践丰富的设计指导并不多见，我们有幸看到了微软团队的作品——Microsoft REST API Guidelines，因此才有了此篇内容。由于公众号文章内容字数有限，接下来我们会将翻译稿拆分并分享出来。翻译的不对之处，请多多指教。

什么是REST API?

Rest不是一种协议，也不是一种文字格式，更不是一种开发框架，它是一种系列的设计约束的集合：无状态性、将超媒体作为应用状态的引擎，这个约束我们统称Fielding约束。也就是说，它是一种软件架构风格、设计风格。它的两大核心理念是资源和表述，这个能加快我们对它的理解，然而REST -- REpresentational State Transfer，英语的直译就是“表现层状态转移”。upload/201811051627527620.png") 1% 50% no-repeat scroll rgb(255, 254, 254);">作者：