Skip to content
Easily consume a json:api service in Javascript.
JavaScript
Branch: master
Clone or download
Pull request Compare This branch is 77 commits behind holidayextras:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
documentation
lib
test
.codeclimate.yml
.coveralls.yml
.editorconfig
.eslintrc
.gitignore
.jshintrc
.npmignore
.travis.yml
CHANGELOG.md
CONTRIBUTING.md
LICENSE
README.md
karma.local.conf.js
karma.saucelabs.conf.js
package.json

README.md

Coverage Status Build Status Code Climate Codacy Badge Dependencies Status

Sauce Test Status

jsonapi-client

A javascript module designed to make it really easy to consume a json:api service.

Motivation / Justification / Rationale

Consuming a json:api service from within Javascript is a non-trivial affair. Setting up a transport mechanism, authentication, making requests to standardised HTTP routes, error handling, pagination and expanding an inclusion tree... All of these things represent barriers to consuming an API. This module takes away all the hassle and lets developers focus on interacting with a rich API without wasting developer time focusing on anything other than shipping valuable features.

This module is tested against the example json:api server provided by jsonapi-server.

Full documentation

The tl;dr

In a browser

<script src="/dist/jsonapi-client.min.js"></script>
<script type="text/javascript">
  var client = new JsonapiClient("http://localhost:16006/rest", {
    header: {
      authToken: "2ad1d6f7-e1d0-480d-86b2-dfad8af4a5b3"
    }
  });
</script>

Creating a new Client

var JsonapiClient = require("jsonapi-client");
var client = new JsonapiClient("http://localhost:16006/rest", {
  header: {
    authToken: "2ad1d6f7-e1d0-480d-86b2-dfad8af4a5b3"
  }
});

Creating a new Resource

var article = client.create("articles");
article.set("title", "foobar");
article.sync(function(err) {
  console.log("Resource created");
});

Finding Resources

client.find("articles", function(err, resources) {
  resources.map(function(resource) {
    console.log(resource.toJSON());
  });
});

Getting a specific Resource

client.get("articles", 5, { include: [ "author" ] }, function(err, article) {
  console.log(article.toJSONTree());
});

Fetching a Resource's related Resource

article.fetch("author", function(err) {
  console.log(article.author.toJSON());
});

Updating a Resource's primary relationships

article.relationships("comments").add(comment);
article.sync(function(err) {
  console.log("Resource's relation updated");
});

Deleting a Resource

article.delete(function(err) {
  console.log("Resource deleted");
});
You can’t perform that action at this time.