⚡ FastAPI-REST-APIs - Modern REST API Development

A collection of FastAPI-REST-APIs and exercises demonstrating modern Python web API development, including RESTful services, authentication, database integration, and best practices.

🎯 About

This repository showcases my journey learning FastAPI - a modern, fast (high-performance) web framework for building APIs with Python 3.9+ based on standard Python type hints. This project demonstrates different aspects of API development from basic CRUD operations to advanced features like database integration, and real-time capabilities.

Why FastAPI?

• ⚡ High performance - comparable to NodeJS and Go
• 📚 Automatic interactive API documentation (Swagger UI)
• 🔒 Built-in data validation with Pydantic
• 🚀 Async/await support for concurrent operations
• 🎯 Type hints for better IDE support and fewer bugs

📋 Table of Contents

• Projects Overview
• Features Demonstrated
• Technologies Used
• Installation
• Running the Projects
• API Documentation
• Project Structure
• Learning Resources
• Contact

🚀 Projects Overview

1. Basic CRUD API

Description: Simple REST API for managing items/resources
Endpoints: GET, POST, PUT, DELETE operations
Concepts:

• Path parameters and query parameters
• Request/Response models with Pydantic
• HTTP status codes
• API versioning

---

2. Database Integration (SQLAlchemy)

Description: API with PostgreSQL/MySQL database
Features:

• Database connection and session management
• ORM models with SQLAlchemy
• Database migrations with Alembic
• Relationship mapping (One-to-Many, Many-to-Many)

Concepts:

• Database design patterns
• Connection pooling
• Transaction management

---

3. Todo API with Full Features

Description: Production-ready Todo application API
Features:

• Complete CRUD operations
• Database persistence
• Input validation
• Error handling
• API documentation

Tech Stack: FastAPI + SQLAlchemy + PostgreSQL

---

✨ Features Demonstrated

Core FastAPI Features

• ✅ RESTful API design principles
• ✅ Automatic interactive documentation (Swagger UI & ReDoc)
• ✅ Request/Response validation with Pydantic
• ✅ Dependency injection system
• ✅ Path operations and route handling
• ✅ Query parameters, path parameters, request body
• ✅ Error handling and custom exceptions
• ✅ Status codes and response models

Advanced Features

• 💾 Database integration (SQLAlchemy ORM)
• 🚦 Middleware (CORS, rate limiting, logging)
• 📊 API versioning
• 🧪 Testing with pytest
• 📝 API documentation best practices

🛠️ Technologies Used

Technology	Purpose
FastAPI	Web framework
Uvicorn	ASGI server
Pydantic	Data validation
SQLAlchemy	ORM for database
PostgreSQL/MySQL	Relational database

📦 Installation

Prerequisites

• Python 3.9 or higher
• pip (Python package manager)
• PostgreSQL/MySQL (for database projects)
• Git

Setup Instructions

1. Clone the repository

https://github.com/nushant22/FastAPI-REST-APIs.git
cd FastAPI-REST-APIs

2. Create virtual environment

# On Windows
python -m venv venv
venv\Scripts\activate

# On macOS/Linux
python3 -m venv venv
source venv/bin/activate

3. Install dependencies

pip install -r requirements.txt

4. Set up environment variables

# Create .env file
cp .env.example .env

# Edit .env with your configuration
# DATABASE_URL=postgresql://user:password@localhost/dbname

5. Set up database (for projects requiring database)

# Run migrations
alembic upgrade head

🚀 Running the Projects

Start the development server

# Navigate to specific project folder
cd project_folder_name

# Run with uvicorn
uvicorn main:app --reload

# Or specify host and port
uvicorn main:app --host 0.0.0.0 --port 8000 --reload

Access the application

• API: http://localhost:8000
• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

📚 API Documentation

Each project includes automatic interactive documentation:

Swagger UI (OpenAPI)

Visit /docs endpoint to:

• View all available endpoints
• Test API calls directly in browser
• See request/response schemas
• View authentication requirements

Example API Endpoints

# Health check
GET /health

# User authentication
POST /auth/register
POST /auth/login
POST /auth/refresh

# CRUD operations
GET    /api/v1/items          # Get all items
GET    /api/v1/items/{id}     # Get specific item
POST   /api/v1/items          # Create new item
PUT    /api/v1/items/{id}     # Update item
DELETE /api/v1/items/{id}     # Delete item

Sample Request/Response

POST /api/v1/items

// Request Body
{
  "name": "Sample Item",
  "description": "This is a sample item",
  "price": 29.99,
  "is_available": true
}

// Response (201 Created)
{
  "id": 1,
  "name": "Sample Item",
  "description": "This is a sample item",
  "price": 29.99,
  "is_available": true,
  "created_at": "2026-02-16T10:30:00Z"
}

📂 Project Structure

FASTAPI-REST-APIs/
│
├── frontend/                      # Frontend (React)
│   ├── public/
│   │   ├── index.html             # HTML entry point
│   │   └── manifest.json          # Web app metadata
│   │
│   ├── src/
│   │   ├── App.js                 # Root React component
│   │   ├── App.css                # Global app styles
│   │   ├── index.js               # React DOM entry
│   │   ├── index.css              # Base CSS styles
│   │   ├── TaglineSection.js      # Tagline UI component
│   │   └── TaglineSection.css     # Tagline component styles
│   │
│   ├── package.json               # Frontend dependencies & scripts
│   └── package-lock.json          # Locked dependency versions
│
├── .gitignore                     # Git ignore rules
├── main.py                        # FastAPI app entry point
├── database.py                    # Database connection setup
├── models.py                      # SQLAlchemy models
├── database_models.py             # Database schema definitions
├── requirements.txt               # Python dependencies
├── README.md                      # Project documentation

📖 Learning Resources

Official Documentation

• FastAPI Official Docs
• Pydantic Documentation
• SQLAlchemy Documentation

Tutorials I Found Helpful

• FastAPI Tutorial - User Guide
• Real Python - FastAPI Guide
• TestDriven.io - FastAPI Course

Video Courses

• FastAPI - freeCodeCamp
• FastAPI Full Course - Sanjeev Thiyagarajan

🎓 Key Learnings

Through these FastAPI projects, I've gained:

• ✅ Modern Python web development skills
• ✅ RESTful API design principles
• ✅ Database design and ORM usage
• ✅ API testing and documentation

🤝 Contributing

Contributions are welcome! If you have improvements or new examples:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/NewExample)
3. Commit your changes (git commit -m 'Add new example')
4. Push to the branch (git push origin feature/NewExample)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

📧 Contact

Nushant Ghimire

• LinkedIn: nushant-ghimire-861b87325
• GitHub: @nushant22
• Email: [nushantghimire22@gmail.com]

🙏 Acknowledgments

• FastAPI creator Sebastián Ramírez
• FastAPI community for excellent documentation
• Stack Overflow community for troubleshooting help

---

⭐ If you find this repository helpful, please give it a star!

🚀 Building APIs with FastAPI? Let's connect and share knowledge!

Last Updated: February 2026