Package Exports
- json-server/package.json
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (json-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
JSON Server

Give it a JSON or JS seed file and it will serve it through REST routes.
Created with <3 for front-end developers who need a flexible back-end for quick prototyping and mocking.
Powers http://jsonplaceholder.typicode.com
Examples
Command line interface
// db.json
{
"posts": [
{ "id": 1, "body": "foo" }
]
}
$ json-server db.json
$ curl -i http://localhost:3000/posts/1
Node module
var server = require('json-server');
server({
posts: [
{ id: 1, body: 'foo' }
]
}).listen(3000);
You can find a running demo here: http://jsonplaceholder.typicode.com.
Why?
- Lets you use plain JSON or simple JS file
- Supports GET but also POST, PUT, DELETE and even PATCH requests
- Can be used from anywhere through cross domain requests (JSONP or CORS)
- Can load remote JSON files (JSON Generator, ...)
- Can be deployed on Nodejitsu, Heroku, ...
Installation
$ npm install -g json-server
CLI usage
json-server <source>
Examples:
json-server db.json
json-server file.js
json-server http://example.com/db.json
Options:
--help, -h Show help
--version, -v Show version number
--port, -p Set port [default: 3000]
Input
Here's 2 examples showing how to format JSON or JS seed file:
- db.json
{
"posts": [
{ "id": 1, "body": "foo" },
{ "id": 2, "body": "bar" }
],
"comments": [
{ "id": 1, "body": "baz", "postId": 1 },
{ "id": 2, "body": "qux", "postId": 2 }
]
}
- file.js
module.exports = function() {
var data = {};
data.posts = [];
data.posts.push({ id: 1, body: 'foo' });
//...
return data;
}
JSON Server expects JS files to export a function that returns an object.
Seed files are useful if you need to programmaticaly create a lot of data.
Routes
GET /:resource
GET /:resource?filter=&filter=&
GET /:parent/:parentId/:resource
GET /:resource/:id
POST /:resource
PUT /:resource/:id
PATCH /:resource/:id
DEL /:resource/:id
To slice resources, add _start
and _end
.
GET /:resource?_start=&_end=
GET /:resource?filter=&filter=&_start=&_end=
GET /:parent/:parentId/:resource?_start=&_end=
To make a full-text search on resources, add q
.
GET /:resource?q=
For routes usage information, have a look at JSONPlaceholder code examples.
GET /db
Returns database state.
GET /
Returns default index file or content of ./public/index.html (useful if you need to set a custom home page).