أول API بـ FastAPI

pip install "fastapi[standard]"

from fastapi import FastAPI

app = FastAPI(title="My first API")

@app.get("/")                             # GET request to the root URL
def home():
    return {"message": "Ahlan! The API is running"}

@app.get("/square/{number}")              # path parameter
def square(number: int):                  # type hint -> automatic validation
    return {"number": number, "square": number ** 2}

@app.get("/greet")
def greet(name: str, lang: str = "ar"):   # query parameters (?name=...&lang=...)
    text = f"أهلاً يا {name}" if lang == "ar" else f"Hello {name}"
    return {"greeting": text}

fastapi dev hello_api.py
# Now open in your browser:
#   http://127.0.0.1:8000/square/12
#   http://127.0.0.1:8000/docs      <- interactive docs, try every endpoint!

from fastapi.testclient import TestClient
from hello_api import app

client = TestClient(app)

print(client.get("/").json())
print(client.get("/square/12").json())
print(client.get("/greet", params={"name": "Sara"}).json())

bad = client.get("/square/twelve")          # not a number!
print(bad.status_code, bad.json()["detail"][0]["msg"])