Exception Taxonomy

Hierarchical exception system with HTTP status codes, error codes, and structured responses for consistent API error handling.

When to Use This Skill

• Building APIs that need consistent error responses
• Creating machine-readable error codes for client handling
• Implementing retry logic based on error types
• Standardizing error handling across a large codebase

Core Concepts

A well-designed exception taxonomy provides:

• Consistent error responses across all endpoints
• Machine-readable error codes for client handling
• Human-readable messages for debugging
• HTTP status code mapping
• Retry hints for transient failures