Exceptions API

The exceptions module provides custom exceptions for the USDA FDC client.

FdcApiError

class usda_fdc.exceptions.FdcApiError[source]

Base exception for all FDC API errors.

class usda_fdc.exceptions.FdcAuthError[source]

Exception raised when authentication fails.

class usda_fdc.exceptions.FdcRateLimitError[source]

Exception raised when the API rate limit is exceeded.

class usda_fdc.exceptions.FdcTimeoutError[source]

Exception raised when a request to the FDC API times out.

Distinct from a generic FdcApiError so callers can tell “slow” from “broken” — a timeout is usually worth retrying, a 400 is not.

class usda_fdc.exceptions.FdcValidationError[source]

Exception raised when input validation fails.

class usda_fdc.exceptions.FdcResourceNotFoundError[source]

Exception raised when a requested resource is not found.