3、API设计与构建：从理论到实践

API设计与构建：从理论到实践

1. 会议系统架构演进决策

会议系统需要进行升级，以支持移动应用程序并与外部CFP系统集成。移动应用和外部CFP系统都需要访问参会者信息，以便将用户登录到第三方服务。为了满足这些需求，做出了将参会者组件拆分为独立服务的决策。

1.1 决策内容

将参会者组件拆分为独立服务，这样可以实现API优先的开发方式，允许从遗留会议服务中调用该API，并且支持直接访问参会者服务，为外部CFP系统提供用户信息。

1.2 决策后果

• 延迟问题 ：对参会者服务的调用可能不会在进程外进行，这可能会引入延迟，需要进行测试。
• 单点故障风险 ：参会者服务可能成为架构中的单点故障，需要采取措施减轻运行单个参会者服务可能带来的潜在影响。
• 设计、版本控制和测试要求 ：由于计划采用多消费者模型，需要确保良好的设计、版本控制和测试，以减少意外的兼容性破坏。

1.3 ADR指南

为了帮助在API架构决策过程中收集重要问题，提供了ADR（架构决策记录）指南。该指南的格式如下表所示：
| 部分 | 描述 |
| — | — |
| 决策 | 描述在考虑相关方面时可能需要做出的决策 |
| 讨论要点 | 帮助识别在进行API架构决策时应进行的关键讨论 |
| 建议 | 提供在创建ADR时应考虑的具体建议，并解释建议的理由 |

2. API设计基础