How to Create a REST API with FastAPI

🚀 How to Create a REST API with FastAPI: From Zero to Swagger Hero 🚀

Let’s be honest: building APIs used to be about as much fun as debugging CSS. (You know it’s true.) But then along came FastAPI, and suddenly, building REST APIs feels less like wrestling a bear and more like assembling LEGO—if those LEGO bricks came with automatic documentation and type hints.

So, curious coder, ready to unleash your inner API architect? Let’s blend a little wit with wisdom and walk through spinning up your first REST API with FastAPI. Spoiler: You’ll have a working API before your coffee gets cold.

1. FastAPI: The TL;DR

Think of FastAPI as Python’s answer to “I want it fast, and I want it easy.” It’s built on top of Starlette and Pydantic, which means you get async support and data validation baked in—no extra toppings required.

2. Install It Before You Grill It

First, let’s install the essentials:

pip install fastapi uvicorn

uvicorn is the ASGI server that makes FastAPI go vroom.

3. Hello, World! (Or: The API Equivalent)

Here’s a minimal API that says hello. (Impress your friends. Or at least your linter.)

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
async def read_root():
    return {"message": "Hello, API World!"}

Run it with:

uvicorn main:app --reload

(“–reload” gives you hot-reloading. Because who wants to stop and start servers like it’s 2007?)

4. Meet Your Endpoints: CRUD Without the Crud

Let’s get a little fancier and build a To-Do API. Because, let’s face it, who doesn’t love lists?

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()

class Todo(BaseModel):
    task: str
    done: bool = False

todos = []

@app.post("/todos")
def create_todo(todo: Todo):
    todos.append(todo)
    return {"message": "To-Do added!", "todo": todo}

@app.get("/todos")
def read_todos():
    return todos

Now you can:
– Create a to-do with a POST request.
– Retrieve all to-dos with a GET request.

And voila—your API just leveled up from “Hello World” to “I’m actually useful.”

5. Automatic Docs: Because Reading Minds is Hard

Point your browser to http://localhost:8000/docs and prepare to be dazzled: FastAPI auto-generates interactive Swagger docs. No more writing documentation that nobody reads (except, perhaps, you in six months).

6. Why FastAPI Rocks (Besides the Name)

• Speed: Async support out of the box. Your API can handle more requests than a cat meme on Reddit.
• Type safety: If you love autocompletion and hate runtime errors, FastAPI’s type hints are your spirit animal.
• Documentation: Your endpoints document themselves, like magic elves.

Final Reflection

With FastAPI, building a REST API is less about suffering and more about sipping coffee while your endpoints hum along. Who knew Python could be so…fast?

Now go forth and API-ify your ideas. Just don’t forget to check your to-do list—after all, you built it!

Stay curious, keep coding, and may your servers always be as fast as your ambition. 🚀

—Pichai (well, almost)