json-server

github.com又名 json-server

开源的假 REST API 生成工具,读取一份 JSON 文件即可提供增删改查、条件筛选、排序分页和 _embed 关联查询,适合前端在等后端接口时先对着真实地址把列表、详情和提交跑通。

打开官网替代品 10 个 本站 11 月 22 日 实测:国内不可直接访问
最近 5 次实测

2 次可以打开平均 4.6 秒11 月 22 日 起国内不可直接访问11 月 10 日 起国内不可直接访问

本站从国内机房定期实测。竖条由远及近:绿 = 可以打开,橙 = 国内不可直接访问,灰 = 打不开。
github.comjson-server 首页截图

github.com 首页 · 本站实拍 · 点开看大图

json-server 是一个跑在 Node.js 上的小工具,把一份 JSON 文件变成一个能用的 REST API。前端还没等到后端接口时,可以先写个 db.json,把 posts、comments 这类数据放进去,起服务后就能对着真实地址发请求,页面上的列表、详情、提交都能跑通,不用自己写一行服务端代码。

怎么用

先装包,再建一个 db.json 或 db.json5,里面按资源名放数组,比如 posts 数组和 comments 数组,另可放一个 profile 这样的单对象。执行 npx json-server db.json 后,服务默认起在 3000 端口,访问 /posts/1 就能拿到对应记录。数组资源支持 GET、POST、PUT、PATCH、DELETE,单对象资源只支持读取和修改。

查询能力

查询参数是它比较顺手的地方,不用额外配置:

  • 条件筛选,如 views:gt=100、title:contains=hello,支持大于、小于、等于、包含、前后缀等操作符
  • 排序,_sort=-views 表示按浏览量倒序,也能多字段排序
  • 分页,_page=1&_per_page=10,返回结果里带页码和总数
  • 关联,_embed=comments 把子资源嵌进父资源,_where 可以写更复杂的组合条件

适合谁,注意什么

适合做前端原型、写自动化测试、教学演示 REST 接口的人,也适合临时给移动端或页面造一批假数据。它把数据存在本地文件里,重启不丢,但也不是给生产环境用的数据库。仓库页面顶部提示当前展示的是 v1 beta 文档,接口可能有破坏性改动,想要稳定版得看旧文档。项目以 MIT 协议开源,仓库有 75.7k 星标、7.3k 分支。

常见问题

json-server 收费吗?
json-server 免费使用。
用 json-server 要登录吗?
不用登录就能用。
json-server 有哪些平台 / App?
支持 Windows、macOS、Linux。

替代品全部 10 个,带对比表 →

替代品 10打开官网