Module: Asana::Errors

Included in:

HttpClient::ErrorHandling

Defined in:

lib/asana/errors.rb

Overview

Defines the different errors that the Asana API may throw, which the client code may want to catch.

Constant Summary

APIError =

Note:

This exception should never be raised when there exists a more specific subclass.

A generic, catch-all API error. It contains the whole response object for debugging purposes.

Class.new(StandardError) do
  attr_accessor :response

  def to_s
    'An unknown API error ocurred.'
  end
end

NotAuthorized =

A 401 error. Raised when the credentials used are invalid and the user could not be authenticated.

Class.new(APIError) do
  def to_s
    'A valid API key was not provided with the request, so the API could '\
    'not associate a user with the request.'
  end
end

Forbidden =

A 403 error. Raised when the user doesn’t have permission to access the requested resource or to perform the requested action on it.

Class.new(APIError) do
  def to_s
    'The API key and request syntax was valid but the server is refusing '\
    'to complete the request. This can happen if you try to read or write '\
    'to objects or properties that the user does not have access to.'
  end
end

NotFound =

A 404 error. Raised when the requested resource doesn’t exist.

Class.new(APIError) do
  def to_s
    'Either the request method and path supplied do not specify a known '\
    'action in the API, or the object specified by the request does not '\
    'exist.'
  end
end

ServerError =

A 500 error. Raised when there is a problem in the Asana API server. It contains a unique phrase that can be used to identify the problem when contacting developer support.

Class.new(APIError) do
  attr_accessor :phrase

  def initialize(phrase)
    @phrase = phrase
  end

  def to_s
    "There has been an error on Asana's end. Use this unique phrase to "\
    'identify the problem when contacting developer support: ' +
    %("#{@phrase}")
  end
end

InvalidRequest =

A 400 error. Raised when the request was malformed or missing some parameters. It contains a list of errors indicating the specific problems.

Class.new(APIError) do
  attr_accessor :errors

  def initialize(errors)
    @errors = errors
  end

  def to_s
    errors.join(', ')
  end
end

RateLimitEnforced =

A 429 error. Raised when the Asana API enforces rate-limiting on the client to avoid overload. It contains the number of seconds to wait before retrying the operation.

Class.new(APIError) do
  attr_accessor :retry_after_seconds

  def initialize(retry_after_seconds)
    @retry_after_seconds = retry_after_seconds
  end

  def to_s
    "Retry your request after #{@retry_after_seconds} seconds."
  end
end