JSPM

  • Created
  • Published
  • Downloads 290548
  • Score
    100M100P100Q183381F
  • License MIT

Serves JSON files through REST routes.

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 Build Status NPM version

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).