Bulk operations in FastAPI - Mini Project: Build & Apply

Bulk Operations with FastAPI

📖 Scenario: You are building a simple FastAPI app to manage a list of products. You want to add a feature that allows clients to add multiple products at once in a single request.

🎯 Goal: Create a FastAPI app that accepts a bulk list of products via a POST request and stores them in memory.

📋 What You'll Learn

Create a list called products to store product dictionaries

Define a Pydantic model called Product with fields id (int) and name (str)

Create a POST endpoint /add-products that accepts a list of Product items

Add the received products to the products list

💡 Why This Matters

🌍 Real World

Bulk operations are common in APIs to efficiently add or update many items at once, such as uploading multiple products to an online store.

💼 Career

Understanding how to handle bulk data input and output is essential for backend developers building scalable and user-friendly APIs.

1

Data Setup: Create the products list

Create a list called products initialized as an empty list to store product dictionaries.

FastAPI

# Create an empty list called products
# Your code here

Need a hint?

Use products = [] to create an empty list.

2

Configuration: Define the Product model

Define a Pydantic model called Product with two fields: id of type int and name of type str.

FastAPI

from pydantic import BaseModel

products = []

# Define Product model here
# Your code here

Need a hint?

Use class Product(BaseModel): and define the fields inside.

3

Core Logic: Create the FastAPI app and POST endpoint

Create a FastAPI app instance called app. Then create a POST endpoint /add-products that accepts a list of Product items as the request body parameter named new_products. Inside the endpoint, add each product from new_products to the products list as a dictionary using .dict().

FastAPI

from fastapi import FastAPI
from pydantic import BaseModel

products = []

class Product(BaseModel):
    id: int
    name: str

# Create FastAPI app instance
app = FastAPI()

# Create POST endpoint /add-products
@app.post("/add-products")
async def add_products(new_products: list[Product]):
    # Add each product to products list
    # Your code here

Need a hint?

Use for product in new_products: and append product.dict() to products.

4

Completion: Add a GET endpoint to view all products

Add a GET endpoint /products that returns the current products list.

FastAPI

from fastapi import FastAPI
from pydantic import BaseModel

products = []

class Product(BaseModel):
    id: int
    name: str

app = FastAPI()

@app.post("/add-products")
async def add_products(new_products: list[Product]):
    for product in new_products:
        products.append(product.dict())

# Add GET endpoint /products to return products list
# Your code here

Need a hint?

Define a GET endpoint that returns the products list.