预期的效果
- ✅ 完全免费(每月 750 小时免费运行时间)
- ✅ 公共 URL(如
https://your-api.onrender.com) - ✅ 自动部署(Git 提交后自动发布)
- ✅ 基于您的 Mockoon 配置
完整分步教程
第一步:准备 Mockoon 环境文件
- 在 Mockoon 中设计好您的 API。
- 点击 ... -> Show data file in explorer/finder。
- 保存为
mock-api.json(建议用英文文件名)。
第二步:创建 GitHub 仓库
- 访问 github.com 创建新仓库(如
salesforce-mock-api-render)。 - 选择 Public(必须公开)。
- 将
mock-api.json文件上传到仓库。
第三步:创建 package.json 文件
在仓库中创建 package.json,这是 Render 识别为 Node.js 项目的关键:
{
"name": "salesforce-mock-api",
"version": "1.0.0",
"description": "Mock API for Salesforce testing",
"main": "index.js",
"scripts": {
"start": "mockoon-cli start --data mock-api.json --port 10000"
},
"dependencies": {
"@mockoon/cli": "^9.2.0"
},
"keywords": ["mock", "api", "salesforce"],
"author": "Lawrence Kuang",
"license": "MIT"
}
重要:将
YOUR_GITHUB_USERNAME 和 YOUR_REPO_NAME 替换为您的实际信息。
第四步:注册并配置 Render
-
注册 Render:
- 访问 render.com
- 点击 Sign Up 并选择 Sign up with GitHub
-
创建 Web Service:
- 在 Render 控制台点击 New + -> Web Service
- 选择 Connect your repo 并授权访问您的 GitHub 账户
- 选择您创建的仓库(
salesforce-mock-api-render)
-
配置部署设置:
# 基本设置 Name: salesforce-mock-api # 给服务起个名字 Region: Singapore (Southeast Asia) # 选择离你近的区域 Branch: master # 部署的分支 # 环境设置 Runtime: Node Build Command: npm install Start Command: npm start # 套餐选择 Plan: Free # 一定要选择免费套餐
-
高级设置 :
- 点击 Advanced
- 在 Environment Variables 中添加:
Key: PORT Value: 10000- 因为 Render 会随机分配端口,但我们需要固定端口给 Mockoon。
-
创建服务:
- 点击 Create Web Service
- 部署会自动开始
第五步:获取您的公共 URL
-
部署完成后(约 2-5 分钟),在服务页面顶部可以看到您的公共 URL。
-
格式为:
https://your-api.onrender.com -
测试您的 API:
https://your-api.onrender.com/store/products https://your-api.onrender.com/customers
第六步:解决 Render 免费套餐的"睡眠"问题
Render 免费服务在 15 分钟无活动后会自动休眠,下次访问时需要约 30-50 秒"唤醒"。
解决方案:设置定时唤醒
-
使用 UptimeRobot(免费) :
- 访问 uptimerobot.com
- 注册账户
- 点击 Add New Monitor
- 配置如下:
Monitor Type: HTTP(s) Friendly Name: Wake Render API URL: https://your-api.onrender.com/health Monitoring Interval: 5 minutes- 这样每 5 分钟访问一次,保持服务一直活跃
-
在 Mockoon 中添加健康检查端点:
- 在 Mockoon 中添加一条新路由:
Method: GET Path: /health Response: { "status": "ok" } Status: 200- 重新导出
mock-api.json并推送到 GitHub
项目文件结构参考
您的 GitHub 仓库应该包含以下文件:
salesforce-mock-api-render/
├── mock-api.json # Mockoon 导出的环境文件
├── package.json # Node.js 项目配置
└── README.md # 可选,说明文档
现在您就拥有了一个完全免费的、公开可访问的 Mock API 服务!团队中的任何人都可使用这个统一的 URL 进行测试。