from fastapi import Request from fastapi.responses import JSONResponse from uuid import uuid4 class ApiError(Exception): def __init__( self, status_code: int, code: str, message: str, headers: dict[str, str] | None = None, ) -> None: self.status_code = status_code self.code = code self.message = message self.headers = headers or {} class InvalidRequest(ApiError): def __init__(self, message: str = "Invalid request.") -> None: super().__init__(400, "invalid_request", message) class Unauthorized(ApiError): def __init__(self, scheme: str = "Bearer") -> None: if scheme == "Basic": challenge = 'Basic realm="messenger", charset="UTF-8"' else: challenge = 'Bearer realm="messenger"' super().__init__( 401, "unauthorized", "Authentication is required.", {"WWW-Authenticate": challenge}, ) class NotFound(ApiError): def __init__(self, message: str = "Object not found.") -> None: super().__init__(404, "not_found", message) class Conflict(ApiError): def __init__(self, message: str = "Conflict.") -> None: super().__init__(409, "conflict", message) class Unavailable(ApiError): def __init__(self) -> None: super().__init__(503, "unavailable", "Service is unavailable.") def request_id(request: Request) -> str: return getattr(request.state, "request_id", str(uuid4())) async def api_error_handler( request: Request, exc: ApiError, ) -> JSONResponse: rid = request_id(request) headers = { "X-Request-Id": rid, **exc.headers, } return JSONResponse( status_code=exc.status_code, content={ "error": { "code": exc.code, "message": exc.message, "request_id": rid, } }, headers=headers, )