Chuck1sn《你不知道的 Java》什么是好的 Web Api 设计 (第一章) 中发帖

Web Api 的重要性
设计 api 端点是后端开发经常接触的工作,但你是否从来没有想过好的 web api 应该是什么样子呢?
其实 Api 端点就像一张名片一样——专业的名片可以迅速帮助你与客户之间建立信任感;糟糕的名片会让你的产品在被使用前,就给客户留下负面印象。一旦客户对你的产品产生负面情绪,这种情绪就会蔓延到产品生态圈甚至于相关公司上。
本篇文章我和大家分享一些 api 设计的套路与规范,让你也能设计出优雅、健壮、扩展性强的应用程序接口。
设计原则,如果有的话
先让我们回顾曾经提到过的关于设计模式的内容:设计模式的精髓在于设计原则,而非模式的生搬硬套。与此类似,优雅的 Web Api 有两个重要原则如下所示:

设计规范明确的内容必须遵守相关规范
没有设计规范的内容必须遵守相关事实标准

也许你依然对如何设计 web api 毫无头绪,但是别着急,好的创作总是从模仿开始...