feat(api): add /api/v1/summarize endpoint and integration tests

app/api/v1/routes.py

@@ -3,11 +3,10 @@ API v1 routes for the text summarizer backend.
 """
 from fastapi import APIRouter
 
+from .summarize import router as summarize_router
+
 # Create API router
 api_router = APIRouter()
 
-# Import and include route modules here
-# from .endpoints import summarize, health
-
-# api_router.include_router(summarize.router, prefix="/summarize", tags=["summarize"])
-# api_router.include_router(health.router, prefix="/health", tags=["health"])
+# Include v1 routers
+api_router.include_router(summarize_router, prefix="/summarize", tags=["summarize"])

app/api/v1/summarize.py

@@ -0,0 +1,24 @@
+"""
+Summarization endpoints.
+"""
+from fastapi import APIRouter, HTTPException
+from app.api.v1.schemas import SummarizeRequest, SummarizeResponse
+from app.services.summarizer import ollama_service
+
+router = APIRouter()
+
+
+@router.post("/", response_model=SummarizeResponse)
+async def summarize(payload: SummarizeRequest) -> SummarizeResponse:
+    """Summarize input text using Ollama service."""
+    try:
+        result = await ollama_service.summarize_text(
+            text=payload.text,
+            max_tokens=payload.max_tokens or 256,
+            prompt=payload.prompt or "Summarize the following text concisely:",
+        )
+        return SummarizeResponse(**result)
+    except Exception as e:
+        raise HTTPException(status_code=502, detail=f"Summarization failed: {str(e)}")
+
+

tests/test_api.py

@@ -0,0 +1,39 @@
+"""
+Integration tests for API endpoints.
+"""
+import pytest
+from unittest.mock import patch
+from fastapi.testclient import TestClient
+from app.main import app
+
+from tests.test_services import StubAsyncClient, StubAsyncResponse
+
+
+client = TestClient(app)
+
+
+@pytest.mark.integration
+def test_summarize_endpoint_success(sample_text, mock_ollama_response):
+    """Test successful summarization via API endpoint."""
+    stub_response = StubAsyncResponse(json_data=mock_ollama_response)
+    with patch('httpx.AsyncClient', return_value=StubAsyncClient(post_result=stub_response)):
+        resp = client.post(
+            "/api/v1/summarize/",
+            json={"text": sample_text, "max_tokens": 128}
+        )
+        assert resp.status_code == 200
+        data = resp.json()
+        assert data["summary"] == mock_ollama_response["response"]
+        assert data["model"]
+
+
+@pytest.mark.integration
+def test_summarize_endpoint_validation_error():
+    """Test validation error for empty text."""
+    resp = client.post(
+        "/api/v1/summarize/",
+        json={"text": ""}
+    )
+    assert resp.status_code == 422
+
+