Why Path parameters in FastAPI? - Purpose & Use Cases

The Big Idea

Discover how a tiny URL trick can save you hours of messy code!

The Scenario

Imagine building a web app where users can view profiles by typing URLs like /user/123. You try to handle each user ID manually by writing separate code for every possible URL.

The Problem

Manually checking every URL and extracting IDs is slow, messy, and full of mistakes. It's like writing a new rule for every single user instead of having one smart rule that works for all.

The Solution

Path parameters let you define a single URL pattern with placeholders. FastAPI automatically grabs the values from the URL and passes them to your code, making it clean and easy.

Before vs After

✗ Before

if url == '/user/123': show_user(123)
if url == '/user/456': show_user(456)

✓ After

@app.get('/user/{user_id}')
async def show_user(user_id: int):
    return {'user_id': user_id}

What It Enables

You can build flexible APIs that handle many different inputs with just one simple route.

Real Life Example

When you visit an online store and click on a product, the URL changes to something like /product/42. Path parameters let the site show the right product page without extra code for each product.

Key Takeaways

Manual URL handling is slow and error-prone.

Path parameters let you capture parts of the URL easily.

This makes your code cleaner and your app more flexible.