Flexirest: JSON API

If you are working with a JSON API, you need to activate JSON API by specifying the json_api proxy:

class Article < Flexirest::Base
  proxy :json_api
end

This proxy translates requests according to the JSON API specifications, parses responses, and retrieves linked resources. It also adds the Accept: application/vnd.api+json header for all requests.

It supports lazy loading by default. Unless a compound document is returned from the connected JSON API service, it will make another request to the service for the specified linked resource.

Including associations

To reduce the number of requests to the service, you can ask the service to include the linked resources in the response. Such responses are called "compound documents". To do this, use the includes method:

# Makes a call to: /articles?include=images
Article.includes(:images).all

# Fetch nested resources: /articles?include=images.tags,images.photographer
Article.includes(:images => [:tags, :photographer]).all

# Note: the `includes` method takes precedence over the passed `:include` parameter.
# This will result in query: /articles?include=images
Article.includes(:images).all(include: "author")

Resource type

The type value is guessed from the class name, but it can be set specifically with alias_type:

class Photographer < Flexirest::Base
  proxy :json_api
  # Sets the type in the resource object to "people"
  alias_type :people

  patch :update, '/photographers/:id'
end

Notes

Updating relationships is not yet supported.

---

< Plain requests | Proxying APIs >