DDD API Designer

从领域模型到 REST API 的完整设计指南：CQRS 读写分离、四层数据对象转换链（PO→DO→DTO→VO）、统一响应格式、BFF 多端适配、版本管理与安全设计。

Workflow

1. 识别 Command vs Query — 将领域行为分为命令（写）和查询（读），决定 Method 和端点
2. 设计数据对象转换链 — 建立 PO→DO→DTO→VO 四层转换，各层独立职责
3. 设计 REST 端点 — Command 动词后缀, Query 资源命名
4. 定义统一响应格式 — Result<T> 包装 + 业务错误码体系
5. 应用 BFF — 每前端一个 BFF, 数据聚合 + 格式适配 + 协议转换
6. 选择版本策略 — 推荐 URL Path: /api/v1/orders, CDN 友好
7. 施加安全控制 — AuthN + AuthZ + 三层校验 + 差异化限流

When to Use