7、API 规范反馈与微服务边界确定

API 规范反馈与微服务边界确定

1. 获取 API 规范反馈

API 和服务设计的初始版本，通过基于 OAS 的描述或其他标准来呈现，这是一个重要的里程碑。但要设计出优秀的 API，还需要进行更多的建模工作。

我们需要将端点的设计草案展示给将使用这些 API 和服务的客户端开发人员，并收集他们的反馈。如果之前的步骤需要积极的头脑风暴和工作，那么这一阶段则需要仔细倾听和反思。这对于设计 API 而言是极其重要的一步，如果你想设计出经得起时间考验、受客户端喜爱的 API 和微服务，就必须重视这一步。

1.1 关键决策：收集服务设计反馈

服务设计只有在向目标受众展示并收集反馈，且将反馈应用到初始设计中后才算完成。

在设计服务和 API 时，通常需要考虑两类客户：
- 系统终端用户 ：API 为他们实现用户体验。
- 客户端开发人员 ：他们基于服务（API 或微服务）进行编码，构建如网页或移动应用等终端用户体验。

在相关流程开始时，我们会采访终端用户，收集并理解与他们相关的工作故事。但在流程后期，我们会开始收集客户端开发人员的反馈。这可能早在交互设计阶段就会发生，也可能在生成 OAS 之后、编码之前发生。必须对 API 客户端开发人员进行采访，以测试设计的可用性，避免因可用性差而导致编码成果被他们拒绝。

这两项研究活动都至关重要。前者确保我们做的是正确的事，后者确保我们以正确的方式做事。

1.2 实现微服务

相关方法的最后一步是实现微服务，这一步有意安排在流程的最后。编码是软件工程