54 lines
1.4 KiB
Python
54 lines
1.4 KiB
Python
"""
|
|
Standardized API response utilities for FastAPI services.
|
|
|
|
Usage:
|
|
from app.common.responses import error_response, success_response
|
|
|
|
# Error responses
|
|
return error_response("User not found", 404)
|
|
return error_response("Invalid credentials", 401)
|
|
|
|
# Success responses
|
|
return success_response({"user": user_data})
|
|
return success_response({"message": "Created"}, 201)
|
|
"""
|
|
from fastapi.responses import JSONResponse
|
|
|
|
|
|
def error_response(message: str, status_code: int = 400, details: str = None) -> JSONResponse:
|
|
"""
|
|
Create a standardized error response.
|
|
|
|
Args:
|
|
message: Human-readable error message
|
|
status_code: HTTP status code (default 400)
|
|
details: Optional additional details (e.g., exception info)
|
|
|
|
Returns:
|
|
JSONResponse with error data
|
|
"""
|
|
content = {
|
|
"ok": False,
|
|
"error": message
|
|
}
|
|
if details:
|
|
content["details"] = details
|
|
return JSONResponse(content=content, status_code=status_code)
|
|
|
|
|
|
def success_response(data: dict = None, status_code: int = 200) -> JSONResponse:
|
|
"""
|
|
Create a standardized success response.
|
|
|
|
Args:
|
|
data: Response data dictionary
|
|
status_code: HTTP status code (default 200)
|
|
|
|
Returns:
|
|
JSONResponse with success data
|
|
"""
|
|
content = {"ok": True}
|
|
if data:
|
|
content.update(data)
|
|
return JSONResponse(content=content, status_code=status_code)
|