Skip to content

feat: add comprehensive API documentation for FastAPI backend #23

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Preetham123555 wants to merge 1 commit into
base: main
Choose a base branch
from
Open

feat: add comprehensive API documentation for FastAPI backend #23

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 29 additions & 2 deletions backend/main.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,28 @@
import ai_model
import os

from pydantic import BaseModel
from typing import List, Optional

class Observation(BaseModel):
label: str
value: str

class AnalysisResponse(BaseModel):
filename: str
diagnosis: str
confidence: float
risk_level: str
heatmap: Optional[str] = None
observations: List[Observation]

os.environ["KMP_DUPLICATE_LIB_OK"] = "TRUE"

app = FastAPI()
app = FastAPI(
title="Healthway Diagnostics - Neural Retina API",
version="1.0.0",
description="EfficientNet-B0 powered Diabetic Retinopathy detection with Grad-CAM explainability."
)
app.add_middleware(
CORSMiddleware,
allow_origins=["*"],
Expand All @@ -14,7 +33,15 @@
allow_headers=["*"],
)

@app.post("/analyze")
@app.post(
"/analyze",
summary="Analyze a retinal fundus image",
response_model=AnalysisResponse,
responses={
400: {"description": "Invalid or non-retinal image"},
500: {"description": "Model inference error"}
}
)
async def analyze_image(file: UploadFile = File(...)):
image_bytes = await file.read()

Expand Down