A Resilient Web API Client in Ruby

Ruby HTTP client is not sophisticated enough to handle errors gracefully. I came across a well-designed client for a web service at [AppSignal].

The code for the client is as following:

require 'uri'
require 'net/http'
def get_server_connection(arg1, arg2)
http = nil
retries = 0
uri = URI("http://localhost:8089/")
unless http
puts "Opening TCP connection..."
http = Net::HTTP.start(uri.host, uri.port, read_timeout: 5)
puts "Executing HTTP request..."
res = http.request_get(uri.path)
puts res.code, res.body
return res
rescue Errno::ECONNREFUSED, Net::ReadTimeout => e
# timeout would throw ReadTimeout exception
if (retries+=1) <= 3
puts "Timeout (#{e}), retrying in 1 second..."
sleep(retries) # Sleep more with each failure
retry # re-run the code!!
raise # All retries failed, raise the `last` seen exception
if http
puts "Closing the TCP connection..."
def handle_backend_response(arg1, arg2)
res = get_server_connection(arg1, arg2)
unless res.nil? # did we get a response?
puts res.code, res.body
if res.code == "200"
return get_body_from_response(res.body)
if res.code == "404"
# handle 404 as you wish
return nil
puts "service unavailable"
return nil
view raw webClient.rb hosted with ❤ by GitHub

The code has the following logic:

  1. Try to establish a connection with the server.
  2. The request has a timeout and connection refused exceptions.
  3. If retries fail, code raise the last seen exception.
  4. Each retry has increased timeout.

Written with StackEdit.

Leave a Reply

Please log in using one of these methods to post your comment:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.

%d bloggers like this: