feat: add docs

src/presentation/routing/order.py

@@ -10,7 +10,7 @@ from src.application.domain.enums import OrderStatus
 from src.presentation.decorators import require_access_token, csrf_protect
 from src.presentation.dependencies.commands import get_create_order_command, get_create_payment_cloudkassir_command
 from src.presentation.dependencies.logger import get_logger
-from src.presentation.schemas.order import CreateOrder,CreateOrderResponse,OrderPaymentResponse
+from src.presentation.schemas.order import CreateOrder,CreateOrderResponse,ErrorResponse,OrderPaymentResponse
 from src.presentation.schemas.itpay_payment_models import ItpayPaymentData
 
 order_router = APIRouter(prefix='/order', tags=['orders'])
@@ -20,7 +20,16 @@ order_router = APIRouter(prefix='/order', tags=['orders'])
         '/create',
         response_model=CreateOrderResponse,
         status_code=201,
-        responses={409: {'model': CreateOrderResponse}},
+        responses={
+            400: {'model': ErrorResponse, 'description': 'Bad Request'},
+            401: {'model': ErrorResponse, 'description': 'Unauthorized'},
+            403: {'model': ErrorResponse, 'description': 'Forbidden'},
+            404: {'model': ErrorResponse, 'description': 'Not Found'},
+            409: {'model': CreateOrderResponse | ErrorResponse, 'description': 'Conflict'},
+            500: {'model': ErrorResponse, 'description': 'Internal Server Error'},
+            502: {'model': ErrorResponse, 'description': 'Bad Gateway'},
+            503: {'model': ErrorResponse, 'description': 'Service Unavailable'},
+        },
 )
 #@csrf_protect()
 async def create_order(

src/presentation/schemas/order.py

@@ -38,3 +38,8 @@ class CreateOrderResponse(BaseModel):
     status_code: int
     order: OrderPaymentResponse
 
+
+class ErrorResponse(BaseModel):
+    detail: str
+    status_code: int
+