In diesem Beispiel versuchen wir eine kleine REST-API mit Python aufzubauen.

Installation

Zuerst brauchst du FastAPI und einen ASGI-Server wie Uvicorn:

pip install fastapi uvicorn

Beispiel: Kleine User-API

from fastapi import FastAPI, HTTPException
from pydantic import BaseModel

app = FastAPI()

# Datenmodell (User)
class User(BaseModel):
id: int
name: str
email: str

# Fake-Datenbank (Liste im Speicher)
users_db = [
User(id=1, name="Alice", email="Diese E-Mail-Adresse ist vor Spambots geschützt! Zur Anzeige muss JavaScript eingeschaltet sein."),
User(id=2, name="Bob", email="Diese E-Mail-Adresse ist vor Spambots geschützt! Zur Anzeige muss JavaScript eingeschaltet sein."),
]

# 1) Alle User abrufen
@app.get("/users")
def get_users():
return users_db

# 2) User nach ID abrufen
@app.get("/users/{user_id}")
def get_user(user_id: int):
for user in users_db:
if user.id == user_id:
return user
raise HTTPException(status_code=404, detail="User not found")

# 3) Neuen User anlegen
@app.post("/users", status_code=201)
def create_user(user: User):
users_db.append(user)
return user

# 4) User aktualisieren
@app.put("/users/{user_id}")
def update_user(user_id: int, updated_user: User):
for index, user in enumerate(users_db):
if user.id == user_id:
users_db[index] = updated_user
return updated_user
raise HTTPException(status_code=404, detail="User not found")

# 5) User löschen
@app.delete("/users/{user_id}", status_code=204)
def delete_user(user_id: int):
for index, user in enumerate(users_db):
if user.id == user_id:
del users_db[index]
return
raise HTTPException(status_code=404, detail="User not found")

Server starten

Speichere den Code z. B. als main.py und starte den Server:

uvicorn main:app --reload

• Die API läuft dann unter:
   http://127.0.0.1:8000

• Automatische API-Dokumentation:
  Swagger UI: http://127.0.0.1:8000/docs
  ReDoc: http://127.0.0.1:8000/redoc

Beispiel-Requests

Mit cURL oder httpie:

• Alle User abrufen:

• curl http://127.0.0.1:8000/users

User erstellen:

curl -X POST http://127.0.0.1:8000/users \
-H "Content-Type: application/json" \
-d '{"id":3,"name":"Charlie","email":"Diese E-Mail-Adresse ist vor Spambots geschützt! Zur Anzeige muss JavaScript eingeschaltet sein."}'