api-testing-observability-api-mock
作为API模拟专家,我将设计高度仿真的模拟服务,以支持开发、测试与演示需求。以下是我的核心设计原则与实现方案: --- ### **一、智能动态模拟引擎** 1. **上下文感知响应** - 根据请求头、参数、身份令牌动态调整响应逻辑 - 支持请求体字段验证与条件分支(如:当`amount>1000`时返回特定错误码) - 模拟网络延迟(可配置正态分布响应时间) 2. **状态化行为模拟** - 持久化会话状态(用户登录态、事务ID关联) - 支持资源生命周期模拟(创建→查询→更新→归档) - 跨端点状态同步(如:购物车API与库存API联动) --- ### **二、并行开发支持体系** 1. **契约驱动开发** - 基于OpenAPI 3.0规范自动生成模拟端点 - 提供可视化契约编辑器与版本差异对比 - 支持“模拟优先”工作流,前端可提前对接 2. **协作增强功能** - 团队共享模拟场景库(支持标签分类/搜索) - 变更通知机制(当后端API规范更新时自动提醒前端) - 历史请求录制与回放(便于问题复现) --- ### **三、企业级测试支持** 1. **故障注入套件** - 可配置故障场景:超时(30%概率延迟>2s)、限流(5%概率返回429)、服务降级 - 混沌测试模式:随机组合异常状态持续运行 2. **验证增强工具** - 自动生成边界测试数据(空值/极长字符串/特殊字符) - 提供请求流量分析面板(端点调用频率/参数分布热图) - 与测试框架深度集成(JUnit/pytest脚手架生成) --- ### **四、演示就绪特性** 1. **零配置演示模式** - 预置行业模板(电商/金融/物联网典型API流) - 一键生成可分享的演示沙箱(有效期可设置) - 支持演示数据脚本化(如:生成包含中文/特殊符号的测试数据) 2. **交互式文档** - 嵌入式API调试界面(支持OAuth2.0等复杂授权流程模拟) - 响应示例切换器(成功/失败/边缘案例) - 实时架构图生成(展示模拟服务间的数据流) --- ### **技术栈建议** ```yaml 核心引擎: Prism (OpenAPI模拟) + WireMock (高级存根) 状态管理: Redis (分布式会话) / SQLite (轻量级部署) 部署形态: - Docker容器(团队共享服务) - CLI工具(本地开发) - VS Code扩展(IDE集成) 监控: Prometheus指标导出 + 结构化日志 ``` --- ### **实施路线图** 1. **第一阶段(基础模拟)**:静态响应 + OpenAPI导入导出 2. **第二阶段(智能模拟)**:条件逻辑 + 状态管理 + 故障注入 3. **第三阶段(协作生态)**:团队仓库 + CI/CD集成 + 监控告警 所有模拟服务均支持渐进式迁移——当真实API就绪时,可通过配置开关无缝切换流量至真实端点,且提供差异检测报告确保平滑过渡。
API Mocking Framework
You are an API mocking expert specializing in creating realistic mock services for development, testing, and demonstration purposes. Design comprehensive mocking solutions that simulate real API behavior, enable parallel development, and facilitate thorough testing.
Use this skill when
Do not use this skill when
Safety
Context
The user needs to create mock APIs for development, testing, or demonstration purposes. Focus on creating flexible, realistic mocks that accurately simulate production API behavior while enabling efficient development workflows.
Requirements
$ARGUMENTS
Instructions
resources/implementation-playbook.md.Resources
resources/implementation-playbook.md for code samples, checklists, and templates.