JSON Mock API 生成器 - 接口响应与错误场景在线构造

功能特点

• 根据 resource 生成 /api/mock/{resource} endpoint
• 只选择 200、201、400、404 或 500 状态，并生成固定 name/email 记录
• 输出 status、endpoint 与 data 三个字段，不生成 Headers 或自定义错误体

使用方法

1. 输入资源名称、记录数量并选择 200、201、400、404 或 500
2. 生成后核对规范化 endpoint 和固定 name/email data
3. 保存所需状态夹具；其他状态、Headers 与延迟到专门的 Mock 环境配置

示例输入

• 列表接口响应

  resource: users
  count: 1
  status: 200

  生成包含 status、/api/mock/users endpoint 和固定 name/email 测试记录的 JSON。

• 错误响应模板

  resource: validation errors
  count: 1
  status: 400

  当前工具可切换 HTTP 状态字段，但 data 仍是 name/email 测试记录，不会生成自定义错误体。

• 资源名规范化

  resource: User Orders
  count: 2
  status: 201

  当前实现会把资源名 trim、转小写并把非 ASCII 字母数字折叠为连字符，endpoint 为 /api/mock/user-orders。

• 空资源名回退

  resource: 空
  count: 0
  status: 500

  空资源名会回退为 items，数量仍会按 Mock Data 规则至少生成 1 条，输出只包含固定 name/email 字段。

示例输出

• 列表接口响应

  {"status":200,"endpoint":"/api/mock/users","data":[{"id":1,"name":"Alex Chen","email":"alex.chen@example.com"}]}

• 错误响应模板

  {"status":400,"endpoint":"/api/mock/validation-errors","data":[{"id":1,"name":"Alex Chen","email":"alex.chen@example.com"}]}

• 资源名规范化

  status: 201；endpoint: /api/mock/user-orders；data: 2 条固定 name/email 记录

• 空资源名回退

  status: 500；endpoint: /api/mock/items；data: 1 条固定 name/email 记录（空资源名回退 items）

常见错误

• 只使用 200/201 会漏掉当前可选的 400、404 和 500 分支；鉴权或限流状态需另行构造。
• 字段类型和真实后端不一致，会让前端联调后集中返工。
• 数组数量固定为 1 条时，无法暴露分页、滚动和布局拥挤问题。

适用场景

• 接口响应设计
• 前端状态开发
• 错误态演示
• 契约草稿整理

实操检查

• 验证资源名、状态和数据契约

  固定输入：resource=`User Orders`、count=2、status=201。步骤：在 Mock API 页面填写三项并点击“生成 Mock API”。预期结果：格式化 JSON 的 status 为 201、endpoint 为 `/api/mock/user-orders`、data 长度为 2，且每项含 id、name、email。失败判断：endpoint 未小写连字符化、data 出现未声明字段，或页面发起网络请求。

• 验证空值回退和数量下限

  固定输入：resource 为空、count=0、status=500。步骤：点击“生成 Mock API”。预期结果：输出 endpoint 为 `/api/mock/items`，data 仍有 1 条 id=1 的 name/email 记录。失败判断：输出空数组、endpoint 为空，或没有保留 status=500。

页面专属核验

使用前与操作中

• 先把它当作本地 JSON 响应夹具：当前只生成 status、规范化后的 `/api/mock/{resource}` endpoint，以及固定的 name/email 数据数组。
• 状态分支优先使用页面提供的 200、201、400、404、500；需要 Headers、错误体、延迟、分页或鉴权时，转到真正的 Mock 服务配置。
• 资源名会转小写并把非字母数字字符折叠为连字符，空值回退为 `items`；先确认这是否符合调用方路由，而不是直接当真实 API 路径。

结果出来后

• 生成 `Users / 2` 后，endpoint 是否为 `/api/mock/users`，每条数据是否仅含递增 id、固定 name 和 example.com email？
• status 是否与选择值原样写入，且客户端对 400/404/500 的错误处理是否还需要自定义响应头和错误字段？
• 前端是否只引用了这段 JSON 夹具，而没有误以为页面已经启动了可访问的 HTTP endpoint、重试或延迟行为？

相关工具

• Mock Data 生成器：生成姓名、邮箱、地址等前端测试 JSON 数据
• JSON 工具：统一处理 JSON 格式化、校验、树形查看、Schema、CSV 转换、AI 响应分析和 JSON 修复
• UUID 生成器：生成随机 UUID v4，支持批量、大小写和格式转换
• HTTP Request / cURL Builder：从方法、URL、Headers 和 Body 生成 cURL，并用 AI 分析 API 请求和代码转换

工具边界

• Mock 响应不能证明真实后端的业务逻辑、权限、数据库查询和事务行为正确。
• 浏览器仍会受到 CORS、Cookie SameSite、HTTPS、代理和端口访问策略限制。
• 模拟数据与响应应避免包含生产 Token、用户资料和内部服务地址。

与相似工具的区别

• Mock Data 生成器：Mock API 在固定 name/email 数据外增加 status 与 endpoint；它不生成 Headers、自定义错误体或延迟。

安全与兼容性

• 固定响应文本在本地生成；resource 只用于 endpoint，测试数据仍应使用占位符，不要粘贴真实 Token、账号或客户资料。
• 当前工具不启动 HTTP 服务，也不能证明真实后端的鉴权、CORS、限流、超时、事务和并发行为，联调前必须保留集成测试。

下一步排查

1. 先保存当前页面生成的 status、endpoint 与固定 data，再用 JSON 工具核对字段结构。
2. 需要 401、403、429、Headers、自定义错误体或慢响应时，改用测试服务器、Service Worker 或 Mock 框架。
3. 切换真实接口前，再用 Headers、HTTP 状态码和 cURL 工具检查实际协议与网络行为。

常见问题