当我们在检索、更新或删除自行车资源时，需要通过路径指定要操作的资源，如下所示： 可以看到，路径中包含了一个路径参数{bikeId}，使得 /bi...

我们已经介绍了如何使用 OpenAPI 规范， 对添加自行车和查询自行车两个操作进行了描述。如果你细心阅读，就会发现：这两个操作都对自行车资源进...

我们在前面的一篇文章[https://www.jianshu.com/p/847dc5939f50]中，介绍了了如何描述 API 的查询参数。本...

我们在对资源和操作[https://www.jianshu.com/p/ae64eea7ba13]进行描述时，添加了 responses 属性，...

我们在使用 OpenAPI 规范描述资源和操作[https://www.jianshu.com/p/ae64eea7ba13]时，只是对操作的响...

在上一篇文章[https://www.jianshu.com/p/c832c8928c96]中，我们设计了响应的数据结构。本文继续介绍如何设计参...

在前面的设计过程中，我们已经找出了两个主要的业务实体：自行车和目录，并把他们转换为可以操作的资源。在 API 的消费者和提供者的交互过程中，业务...