kitsu

Kitsu

A Simple and lightweight framework agnostic JSON:API client for Kitsu.io and other APIs

Check out the Migration Guide for breaking changes and new features in 4.x

Features

• JSON-API 1.0 compliant
• Automatically links relationships to data
• Works in Node and on the web
• Uses the Promise API
• Configurable timeout handling

Install

yarn add kitsu
npm install kitsu

Browser Support

Package	Global Usage	Chrome	Firefox	Safari	IE/Edge
Default	> 1%	61+	56+	10+	Edge 15+
Legacy	> 0.1%	49+	48+	5.1+	IE 8+, Edge 14+

Response Comparison

A GET response by a JSON:API server returns:

{
  data: {
    id: '1'
    type: 'articles'
    attributes: {
      title: 'JSON API paints my bikeshed'
    }
    relationships: {
      author: {
        data: {
          id: '42'
          type: 'people'
        }
      }
    }
  }
  included: [
    {
      id: '42'
      type: 'people'
      attributes: {
        name: 'John'
      }
    }
  ]
}

A GET request with kitsu returns:

{
  data: {
    id: '1'
    type: 'articles'
    title: 'JSON API paints my bikeshed'
    author: {
      id: '42',
      type: 'people'
      name: 'John'
    }
  }
}

Usage

import Kitsu from 'kitsu'                 // ES Modules and Babel
const Kitsu = require('kitsu')            // CommonJS and Browserify
const Kitsu = require('kitsu/lib/legacy') // Legacy IE8+ support

const api = new Kitsu()                   // For kitsu.io developers

const api = new Kitsu({                   // For other JSON:API servers
  baseURL: 'https://api.example/2'        // e.g https://api.example/2
})

const { data } = api.get('anime')         // Using with Promises
  .then(res => res)

const { data } = await api.get('anime')   // Using with async/await

// Fetching resources with get() or fetch()
api.get('anime')                          // Collection of resources
api.get('anime/1')                        // Single resource
api.get('anime/1/episodes')               // Single resource's relationship

// Creating resources with post() or create()
api.create('post', {
  content: 'some content'
})

// Updating resources with patch() or update()
api.update('post', {
  id: '1',
  content: 'new content'
})

// Deleting resources
api.remove('post', 1)

Read the Documentation

More Examples

If you're working with Kitsu.io's API, their API docs lists all available resources with their attributes and relationships

Contributing

See CONTRIBUTING

Releases

See CHANGELOG

License

All code released under MIT