Learn best practices to build an API using Ruby on Rails 5/6. The intention with this book it's not only to teach you how to build an API with Rails. The purpose is also to teach you how to build scalable and maintainable API with Rails which means improve your current Rails knowledge. In this book you will learn to:

• Build JSON responses
• Use Git for version controlling
• Testing your endpoints
• Optimize and cache the API

This book is based on "APIs on Rails: Building REST APIs with Rails". It was initially published in 2014 by Abraham Kuri. Since the original work was not maintained, I wanted to update this excellent work. All the source code of this book is available in Asciidoctor format on this repository. So don't hesitate to fork the project if you want to improve it or fix a mistake that I didn't notice.

Update & translation of the API on Rails (EN) book. This book is written using Asciidoctor.

Support the project

As you may know this project take me some times. So if you want to support me you can buy a version on Leanpub:

• Rails 5
  • English version
  • French version
• Rails 6
  • English version
  • French version
  • Spanish version (thanks to Oscar Téllez)

Or you can support me with Liberapay:

Build book

$ git clone https://github.com/madeindjs/api_on_rails/
$ cd api_on_rails
$ bundle install
$ rake "build:pdf[6,fr]"

You can see all build available with rake -T

$ rake -T
rake "build:all[version,lang]"   # Build all versions
rake "build:epub[version,lang]"  # Build an EPUB version
rake "build:html[version,lang]"  # Build an HTML version
rake "build:mobi[version,lang]"  # Build a MOBI version
rake "build:pdf[version,lang]"   # Build a PDF version

License

This book is under MIT license and Creative Common BY-SA 4.0