exception-taxonomy

What problem does it solve?

This Skill provides a robust and hierarchical system for managing API errors, ensuring consistent, machine-readable, and informative error responses across all endpoints.

Core Features & Use Cases

• Consistent Error Responses: Define a standardized structure for all API errors.
• Machine-Readable Codes: Use enumerated error codes for programmatic handling by clients.
• HTTP Status Code Mapping: Associate specific HTTP status codes with different error types.
• Retry Hints: Include retry_after information for transient errors like rate limiting.
• Use Case: When a user attempts to access a resource they don't have permission for, the API consistently returns a 403 Forbidden status with a clear FORBIDDEN error code and a descriptive message, allowing the client to inform the user appropriately.

Quick Start

Implement the provided Python or TypeScript classes to raise structured exceptions for common API error scenarios.