Python Academy · Lekcja

Parametry ścieżki, parametry zapytania i treści żądań

Proszę definiować typowane parametry i schematy treści żądań za pomocą Pydantic.

Parametry ścieżki, parametry zapytania i treści żądań to bezpłatna lekcja Python Academy na CoddyKit. To lekcja 2 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Python Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Python Academy zawiera 4 lekcji w sumie.

Walidacja parametrów ścieżki

Walidatory parametrów ścieżki można dodawać za pomocą Path(), ustawiając ograniczenia ge, le, gt i lt.

from fastapi import FastAPI, Path
app = FastAPI()

@app.get("/items/{item_id}")
def get_item(item_id: int = Path(ge=1, le=1000)):
    return {"item_id": item_id}

# GET /items/0  → 422 (must be >= 1)

Walidacja parametrów zapytania

Za pomocą Query() można dodać do parametrów zapytania walidację, wartości domyślne, aliasy i opisy.

from fastapi import FastAPI, Query
app = FastAPI()

@app.get("/search")
def search(
    q: str = Query(min_length=2, max_length=50),
    page: int = Query(default=1, ge=1),
):
    return {"q": q, "page": page}

Opcjonalne parametry zapytania

Należy użyć | None = None (Python 3.10+) lub Optional[str] = None, aby parametr zapytania był opcjonalny.

from fastapi import FastAPI
app = FastAPI()

@app.get("/users")
def list_users(
    dept: str | None = None,
    active: bool = True
):
    return {"dept": dept, "active": active}

# GET /users → dept=None, active=True
# GET /users?dept=HR&active=false

Wiele wartości jednego parametru zapytania

Listę wartości dla pojedynczego parametru zapytania można przyjmować za pomocą list[str] i Query().

from fastapi import FastAPI, Query
from typing import Annotated
app = FastAPI()

@app.get("/filter")
def filter_items(tags: Annotated[list[str], Query()] = []):
    return {"tags": tags}

# GET /filter?tags=python&tags=web

Zagnieżdżone ciała żądań

Modele Pydantic mogą być zagnieżdżane. FastAPI automatycznie obsługuje zagnieżdżony format JSON.

from fastapi import FastAPI
from pydantic import BaseModel
app = FastAPI()

class Address(BaseModel):
    street: str
    city: str

class User(BaseModel):
    name: str
    address: Address

@app.post("/users")
def create_user(user: User):
    return user.model_dump()

Ograniczenia pól w Pydantic

W modelu należy użyć Field(), aby dodać ograniczenia, wartości domyślne i opisy do poszczególnych pól.

from pydantic import BaseModel, Field

class Product(BaseModel):
    name: str = Field(min_length=1, max_length=100)
    price: float = Field(gt=0)
    quantity: int = Field(ge=0, default=0, description="Items in stock")

Jednoczesne ciało żądania, ścieżka i zapytanie

W jednym endpoincie można połączyć wszystkie trzy typy parametrów. FastAPI rozróżnia je na podstawie położenia: parametry ścieżki znajdują się w adresie URL, proste typy są parametrami zapytania, a modele stanowią ciało żądania.

from fastapi import FastAPI
from pydantic import BaseModel
app = FastAPI()

class ItemUpdate(BaseModel):
    name: str
    price: float

@app.put("/shops/{shop_id}/items/{item_id}")
def update_item(
    shop_id: int,
    item_id: int,
    item: ItemUpdate,
    notify: bool = False,
):
    return {"shop": shop_id, "item": item_id,
            "data": item.model_dump(), "notify": notify}

Przesyłanie plików

Do przyjmowania przesyłanych plików służą UploadFile i File(). Dostęp do zawartości można uzyskać za pomocą await file.read().

from fastapi import FastAPI, UploadFile, File
app = FastAPI()

@app.post("/upload")
async def upload(file: UploadFile = File(...)):
    content = await file.read()
    return {"filename": file.filename, "size": len(content)}

Dane formularza

Do przyjmowania danych formularzy HTML służy Form() (application/x-www-form-urlencoded lub multipart/form-data).

# pip install python-multipart
from fastapi import FastAPI, Form
app = FastAPI()

@app.post("/login")
def login(username: str = Form(...), password: str = Form(...)):
    return {"username": username}

Podsumowanie walidacji żądań

FastAPI automatycznie weryfikuje wszystkie typy parametrów. Nieprawidłowe dane wejściowe powodują zwrócenie kodu HTTP 422 ze szczegółowym błędem, zanim zostanie wywołany handler.

# Auto-validated:
# - Path params: type coercion, Path() constraints
# - Query params: Query() constraints, type coercion
# - Request body: Pydantic model validation
# - All errors → HTTP 422 Unprocessable Entity
# - No manual validation needed

Aliasy i wycofywanie

Za pomocą alias= w Query() lub Field() można akceptować w żądaniu inną nazwę, a za pomocą deprecated=True oznaczać stare parametry jako wycofywane.

from fastapi import FastAPI, Query
app = FastAPI()

@app.get("/items")
def get_items(
    q: str | None = Query(default=None, alias="search-query"),
    old: str | None = Query(default=None, deprecated=True),
):
    return {"q": q, "old": old}

# GET /items?search-query=python

Szybkie sprawdzenie

Jak FastAPI rozróżnia parametr ścieżki, parametr zapytania i ciało żądania?

Podsumowanie

Do określania ograniczeń parametrów należy używać Path()/Query(). Złożone ciała żądań można tworzyć przez zagnieżdżanie modeli Pydantic. Parametry ścieżki, zapytania i ciała żądania można swobodnie łączyć. UploadFile obsługuje pliki, a Form() formularze HTML. FastAPI weryfikuje wszystko przed uruchomieniem handlera.

Często zadawane pytania

Czy lekcja „Parametry ścieżki, parametry zapytania i treści żądań” jest bezpłatna?

Tak — pełny tekst „Parametry ścieżki, parametry zapytania i treści żądań” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Python Academy, przejdź na CoddyKit PRO. Kurs Python Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Parametry ścieżki, parametry zapytania i treści żądań”?

Proszę definiować typowane parametry i schematy treści żądań za pomocą Pydantic. Ćwiczysz Python Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Python Academy?

Nie wymagamy żadnego doświadczenia. Python Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 2 z 4.

Ile czasu zajmuje lekcja „Parametry ścieżki, parametry zapytania i treści żądań”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Python Academy?

Tak. Każda lekcja Python Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

Konfiguracja projektu FastAPI i pierwszy endpoint
Parametry ścieżki, parametry zapytania i treści żądań
Wstrzykiwanie zależności i uwierzytelnianie
Asynchroniczne endpointy i integracja z bazą danych

← Powrót do Python Academy