عقود المسار والاستعلام والأنواع

from typing import Annotated
from fastapi import FastAPI, Query
from fastapi.testclient import TestClient
app = FastAPI()
@app.get("/items")
def items(limit: Annotated[int, Query(ge=1, le=5)] = 2):
    return {"limit": limit}
with TestClient(app) as client:
    print(client.get("/items").json())
    print(client.get("/items?limit=3").json())
    print(client.get("/items?limit=0").status_code)

{'limit': 2}
{'limit': 3}
422

الافتراضي 2 والصالح 3 ويفشل صفر 422 دون عملية خارجية.

from typing import Annotated
from fastapi import FastAPI, Query
from fastapi.testclient import TestClient
app = FastAPI()
@app.get("/search")
def search(tags: Annotated[list[str], Query()]):
    return {"tags": tags}
with TestClient(app) as client:
    response = client.get("/search", params=[("tags", "blue"), ("tags", "green")])
    print(response.json())
    print(client.get("/search").status_code)

{'tags': ['blue', 'green']}
422

تصبح المفاتيح قائمة مرتبة، وتكون مطلوبة دون افتراضي فينتج الغياب 422.