📝 Python Day 12 — FastAPI Notes API

A fully functional Notes REST API built with FastAPI — part of my #60DaysOfPython challenge on Day 12.

---

📋 What This Project Covers

• Pydantic models for request validation (NoteCreate, NoteUpdate)
• Full CRUD operations via REST API
• Path parameters and query parameters
• Partial updates with optional fields
• HTTP error handling with proper status codes
• In-memory storage with auto-incremented IDs
• Bonus: importance filter and keyword search

---

🗂️ API Endpoints

Method	Endpoint	Description
GET	/	Welcome message
GET	/notes	Get all notes (with total count)
GET	/notes?keyword=xyz	Search notes by title keyword
GET	/notes/important	Get only important notes
GET	/notes/{note_id}	Get a single note by ID
POST	/notes	Create a new note
PUT	/notes/{note_id}	Update a note (partial update)
DELETE	/notes/{note_id}	Delete a note by ID

---

🧱 Pydantic Models

NoteCreate — used for POST requests:

class NoteCreate(BaseModel):
    title: str
    content: str
    is_important: bool = False

NoteUpdate — used for PUT requests (all fields optional):

class NoteUpdate(BaseModel):
    title: Optional[str] = None
    content: Optional[str] = None
    is_important: Optional[bool] = None

---

🛠️ Technologies Used

• Python 3
• FastAPI
• Pydantic
• Uvicorn

---

🚀 How to Run

1. Clone the repository:

git clone https://github.com/studyhaxer/python-day12-fastapi-notes-api.git

2. Navigate to the project folder:

cd python-day12-fastapi-notes-api

3. Create and activate virtual environment:

python -m venv venv
venv\Scripts\activate

4. Install dependencies:

pip install "fastapi[standard]"

5. Run the app:

uvicorn main:app --reload

6. Open in browser:

• API: http://127.0.0.1:8000
• Swagger Docs: http://127.0.0.1:8000/docs

---

✅ Testing Checklist

• Create 3 notes via POST
• Fetch all notes — confirm total is 3
• Fetch one note by ID
• Search notes by keyword
• Filter important notes
• Update a note partially
• Delete a note
• Try invalid ID — confirm 404 response

---

📚 What I Learned

• How to define and use Pydantic models in FastAPI
• Difference between NoteCreate and NoteUpdate models
• How optional fields enable partial updates
• Why route order matters in FastAPI
• How query parameters work alongside path parameters
• Proper HTTP status codes for each operation

---

👨‍💻 Author

studyhaxer — Day 12 of #60DaysOfPython | FastAPI Notes API 🚀