Mock REST API 使用方法
- 1
描述每个接口
选择请求方法,输入路径(如 /users/:id),再设置状态码和可选的延迟,用来模拟较慢的网络。
- 2
编写响应内容
粘贴固定的 JSON,或切换到“假数据”,用 {{fullName}} 这样的占位符编写模板,并设置列表数量。
- 3
创建模拟 API
点击“创建模拟 API”获取基础 URL;每个接口都在该 URL 加上其路径的地址响应,并已启用 CORS。
- 4
调用并反复调整
在应用中使用“试用”、curl 或 fetch 调用,然后修改并保存,更改会立即生效;用完后可删除该模拟 API。
限制与 Pro
免费:每个模拟 API 最多 10 个接口,单个内容 100 KB,总计 512 KB,延迟最长 5 秒,生成的列表最多 100 项,每位访客每分钟 120 次请求,每小时可新建 10 个模拟 API,连续 7 天无请求后删除。
Pro 将限制提高到 50 个接口、1 MB 的内容、30 秒的延迟和 1,000 项的列表。 了解 Pro
关于 Mock REST API
Mock REST API 让前端和移动端开发者在真实后端完成之前,就能用上可正常工作的接口。每个模拟 API 都有各自的基础 URL,位于 /api/mock-api/m/ 之下,你定义的每个接口都会在这里按所选的请求方法、路径、状态码、延迟、请求头和 JSON 内容作出响应。路径可以包含参数,例如 /users/:id 可以匹配 /users/7,模板中还能用 {{param(id)}} 回显这个值,或用 {{query(name)}} 读取查询字符串。
假数据模式会用 36 种占位符把 JSON 模板变成逼真的响应,涵盖姓名、邮箱、公司、城市,以及 UUID、日期、价格、指定范围内的数字和 lorem 文本。设置列表数量后,可返回最多 100 项的数组,还能选择多次请求之间数据保持不变(适合快照测试)或每次都变化。200 到 599 的状态码可用来演练 401、404、429、503 等错误状态,最长五秒的延迟可以检验加载状态的表现。
响应始终是带 CORS 头的 JSON,任何来源的浏览器都能调用。模拟 API 不能返回 HTML、设置 Cookie 或重定向,也不会保存收到的请求,更不是数据库:POST 和 PUT 只会返回你配置好的内容,不会保存发送给它们的任何数据。
隐私
为了托管你的接口,你保存的定义(请求方法、路径、状态码、延迟、请求头和内容)会发送并存储在我们的服务器上,同时保存的还有经过哈希处理的编辑令牌、创建时间和最近一次请求的时间,以及请求次数。对接口的请求会被正常响应,但不会记录其内容、请求头或 IP 地址。模拟 API 会在你删除时,或连续 7 天没有请求和编辑后被删除,编辑令牌只保存在当前浏览器中。任何拿到 URL 的人都能调用你的接口,请不要在其中放入机密信息或真实的个人数据。
功能
真实的 HTTPS 接口
支持任意请求方法、路径参数、200 到 599 的状态码、延迟和自定义 X- 请求头。
假数据模板
30 多种占位符,涵盖人物、公司、地点、日期、数字和文本,可生成单个对象或列表。
安全设计
仅限 JSON,已启用 CORS,不记录请求,编辑令牌经哈希处理,7 天未使用即删除。