Exception: SecApi::AuthenticationError

Inherits:

PermanentError

Object
StandardError
Error
PermanentError
SecApi::AuthenticationError

show all

Defined in:: lib/sec_api/errors/authentication_error.rb

Overview

Raised when API authentication fails (401 Unauthorized or 403 Forbidden).

Why PermanentError? The API key is invalid, expired, or lacks permissions. This won’t fix itself - human intervention required (get new key, check subscription, fix configuration). Retrying wastes resources and delays the inevitable failure. Fail fast with actionable error message.

This is a permanent error - indicates an invalid or missing API key. Retrying won’t help; the API key configuration must be fixed.

Examples:

Handling authentication errors

begin
  client.query.ticker("AAPL").search
rescue SecApi::AuthenticationError => e
  # Fix API key configuration
  logger.error("Authentication failed: #{e.message}")
  notify_developer("Invalid API key configuration")
end

Instance Attribute Summary

Attributes inherited from Error

#request_id

Method Summary

Methods inherited from Error

#initialize

Constructor Details

This class inherits a constructor from SecApi::Error