npm install json-server

Create a db.json (or db.json5) file

{ "posts": [ { "id": "1", "title": "a title" }, { "id": "2", "title": "another title" } ], "comments": [ { "id": "1", "text": "a comment about post 1", "postId": "1" }, { "id": "2", "text": "another comment about post 1", "postId": "1" } ], "profile": { "name": "typicode" } }

Pass it to JSON Server CLI

$ npx json-server db.json

Get a REST API

$ curl http://localhost:3000/posts/1 { "id": "1", "title": "a title" }

Run json-server --help for a list of options

Sponsors

Become a sponsor and have your company logo here

Based on the example db.json, you'll get the following routes:

GET /posts GET /posts/:id POST /posts PUT /posts/:id PATCH /posts/:id DELETE /posts/:id # Same for comments 

GET /profile PUT /profile PATCH /profile 

• → ==
• lt → <
• lte → <=
• gt → >
• gte → >=
• ne → !=

GET /posts?views_gt=9000 

• start
• end
• limit

GET /posts?_start=10&_end=20 GET /posts?_start=10&_limit=10 

• page
• per_page (default = 10)

GET /posts?_page=1&_per_page=25 

• _sort=f1,f2

GET /posts?_sort=id,-views 

• x.y.z...
• x.y.z[i]...

GET /posts?author.name=foo GET /posts?author.email=foo GET /posts?tags[0]=foo 

GET /posts?_embed=comments GET /comments?_embed=post 

DELETE /posts/1 DELETE /posts/1?_embed=comments 

If you create a ./public directory, JSON Serve will serve its content in addition to the REST API.

You can also add custom directories using -s/--static option.

json-server -s ./static json-server -s ./static -s ./node_modules

This project uses the Fair Source License. Note: Only organizations with 3+ users need to contribute a small amount through sponsorship sponsor for usage. This license helps keep the project sustainable and healthy, benefiting everyone.

For more information, FAQs, and the rationale behind this, visit https://fair.io/.