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.

Middleware

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

• faraday_middleware (OAuth requests, response parsing, caching, and more)
• faraday_yaml (YAML request/response parsing)
• faraday_middleware-parse_oj (JSON response parsing with Oj)
• faraday-request-timer (adds request time to responses)
• faraday-http-cache (caching)

Unsupported middleware

Less-maintained projects.

• faraday-stack (follow redirects, response parsing, and other) – deprecated in favor of faraday_middleware
• faraday_utf middlewares for processing utf (removed by its author, preserved here as a link to the lostisland/faraday_middleware PR, which also defined it)

Adapters

External repositories for Faraday adapters:

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