用途:把 HTTP API 当作长期存在的资源协议来设计、评审、实现和约束。先发现稳定的领域资源,再定义路由,并在 OpenAPI 契约、实现与验证中保持 HTTP 语义。
主要能力:按 IETF HTTP RFC、Fielding REST 约束、已发布兼容契约、项目策略的优先级裁决设计问题;禁止把业务逻辑、用例、工作流步骤、界面、按钮、控制器或服务方法直接翻译成 API 操作;只允许路径中出现资源名词、稳定标识符和非动作型基础设施前缀。
使用方式:先建立设计边界,读取仓库说明、现有路由、OpenAPI、schema、客户端、测试与约定;再构建资源模型,为每个候选资源记录含义、标识、归属、领域分组、表示、生命周期、规范 URI 与关系;随后定义 HTTP 契约,明确路径、方法、operationId、参数、媒体类型、状态码、错误模型、认证授权、重试、幂等、并发与缓存;再发布和演进 OpenAPI;实现或评审时把校验与授权放在系统边界;最后运行最窄的契约校验、schema diff、类型检查与测试并报告。
限制:资料未提供具体安装命令、收费、价格、平台或效果信息。若能力无法通过已证明的资源模型表达,应停止并报告缺失的领域决策,不得回退到命令式端点。分页配置、过滤语法等需项目级决策,缺失时应报告不完整并停止。