Home

Faraday — your HTTP client on Rack

Faraday is an HTTP client lib 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.

For talking to APIs in a secure way (HTTPS), see Setting up SSL certificates.

2012 2013 will be the year of Faraday. Check out the Roadmap.

Upgrading, check out the new Changelog (regarding 0.8 and above).

Middleware

Apart from bundled request/response middleware that comes with Faraday, these 3rd-party project provide extra middleware:

• faraday_middleware (oauth requests, response parsing, caching, and more)
• faraday-stack (follow redirects, response parsing, and other) – deprecated in favor of faraday_middleware
• faraday_yaml (YAML request/response parsing)
• faraday_middleware-parse_oj (JSON response parsing with Oj)
• faraday_utf middlewares for processing utf

Adapters

External repositories for faraday adapters:

• dm-faraday-adapter (experimental)
• rack-client [] (>= v0.4.2)

Projects using Faraday

Listed alphabetically:

• freckly
• GitHub Services
• her
• instagram
• oauth2
• pandastream
• Tinder
• travis
• twitter
• vk-ruby
• vkontakte_api