faraday/docs/index.md

layout	title	subtitle	feature-img	hide
page	Faraday	Simple, but flexible HTTP client library, with support for multiple backends.	assets/img/home-banner.jpg	true

Faraday is an HTTP client library that provides a common interface over many adapters (such as Net::HTTP) and embraces the concept of Rack middleware when processing the request/response cycle.

{: .text-center} Fork on GitHub{: .btn} Chat with us{: .btn}

{: .mt-60}

Installation

Add this line to your application's Gemfile:

gem 'faraday'

And then execute:

$ bundle

Or install it yourself as:

$ gem install faraday

You can also install the faraday_middleware extension gem to access a collection of useful Faraday middleware.

{: .mt-60}

Usage

Table of contents:

• Introduction

  • The Basics
  • Customizing the Request
  • Streaming Responses

• Middleware

  • Middleware Environment
  • Writing Middleware

• Adapters

• Testing

• Faraday API RubyDoc