Why use application/problem+json instead of plain JSON?

The application/problem+json media type signals to clients that the response follows the RFC 9457 structure, allowing them to use generic error-handling libraries to parse the details programmatically.

How does this skill improve FastAPI development?

It provides boilerplate exception handlers and classes that automatically convert Python exceptions into standardized JSON responses, ensuring your API follows industry best practices without manual configuration.

RFC 9457 is the current active standard for 'Problem Details for HTTP APIs'. It defines a way for HTTP APIs to report machine-readable errors to avoid the need to define new error response formats for every API.

Can I customize the error types for my specific domain?

Yes, the skill includes an Error Type Registry pattern where you can define custom URIs, titles, and status codes specific to your application's business logic.

RFC 9457 API Error Handling

Name: RFC 9457 API Error Handling
Author: yonatangross

byyonatangross

•

Desarrollo de API

Implements RFC 9457 Problem Details to provide standardized, machine-readable HTTP API error responses for modern backend services.

This skill enables backend architects to standardize API error responses using the latest RFC 9457 specification, the successor to RFC 7807. It provides a production-ready implementation for FastAPI that includes Pydantic models for the Problem Details schema, specialized exception classes, and custom handlers. By utilizing this skill, developers can ensure their APIs return consistent, structured JSON error objects (application/problem+json), making it easier for client-side applications and automated systems to interpret and react to errors like validation failures, rate limits, and resource conflicts.

Características Principales

0169 GitHub stars

02Centralized Error Type Registry for consistent API documentation

03Pydantic-based schema for machine-readable error validation

04Support for extension fields to provide additional machine-readable context

05RFC 9457 compliant error responses (application/problem+json)

06Custom FastAPI exception handlers and base ProblemException classes

Casos de Uso

01Migrating legacy API error structures from RFC 7807 to the modern RFC 9457 standard

02Implementing detailed validation error responses that help frontend developers debug issues

03Standardizing error formats across microservices for consistent client consumption

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add yonatangross/orchestkit error-handling-rfc9457

For use in Claude.ai and ChatGPT

Download Skill