FastAPI Backend Development Bootcamp · Leçon

Paramètres de chemin et de requête

Découvrez comment extraire des données dynamiques des URL à l’aide de paramètres de chemin et traiter des paramètres de requête facultatifs.

Paramètres de chemin et de requête est une leçon FastAPI Backend Development Bootcamp gratuite sur CoddyKit. Ceci est la leçon 3 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage FastAPI Backend Development Bootcamp, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours FastAPI Backend Development Bootcamp comprend 4 leçons au total.

Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.

Dynamic URLs for APIs

APIs often carry data right in the URL — fetching a product by ID or filtering a list. FastAPI gives you clean ways to capture that. Let's dig in.

Meet Path Parameters

Path parameters are URL segments that pin down a specific resource, written in curly braces like /items/{item_id}. Perfect for one exact item.

Your First Path Parameter

Match a path segment to a function arg by name: /items/{item_id} maps to item_id. The type hint int auto-converts it.

from fastapi import FastAPI

app = FastAPI()

@app.get("/items/{item_id}")
async def read_item(item_id: int):
    return {"item_id": item_id, "message": "Here is your item!"}

Power of Type Hints

Type hints like item_id: int drive validation. Hit /items/abc and FastAPI returns a clean error automatically. Use str, int, float, bool, UUID.

Handling Multiple Paths

You can take several path parameters in one route. FastAPI matches them by name, so the order in your function signature doesn't matter.

from fastapi import FastAPI

app = FastAPI()

@app.get("/users/{user_id}/items/{item_id}")
async def read_user_item(user_id: int, item_id: str):
    return {"user_id": user_id, "item_id": item_id}

What are Query Parameters?

Query parameters are key-value pairs after a ?, like /items?skip=0&limit=10. They are optional — ideal for filtering, paging, or sorting.

Your First Query Parameter

Any function arg that is not in the path becomes a query parameter automatically. Here, skip and limit are typed integers.

from fastapi import FastAPI

app = FastAPI()

@app.get("/items/")
async def read_items(skip: int = 0, limit: int = 10):
    return {"skip": skip, "limit": limit}

Optional Queries & Defaults

Make a query parameter optional by giving it a default. For a None default, type it as Optional[str] so FastAPI knows it may be missing.

from typing import Optional
from fastapi import FastAPI

app = FastAPI()

@app.get("/products/")
async def read_products(q: Optional[str] = None, page_size: int = 20):
    results = {"page_size": page_size}
    if q:
        results.update({"search_query": q})
    return results

Path + Query Power

Combine both: path parameters are required, query parameters stay optional with defaults. FastAPI sorts out which is which seamlessly.

from typing import Optional
from fastapi import FastAPI

app = FastAPI()

@app.get("/users/{user_id}/orders/")
async def get_user_orders(user_id: int, status: Optional[str] = None, limit: int = 10):
    return {"user_id": user_id, "status": status, "limit": limit, "message": "User orders fetched."}

Quick Check on Parameters

Consider the following FastAPI endpoint:

from typing import Optional
from fastapi import FastAPI

app = FastAPI()

@app.get("/books/{book_id}")
async def get_book(book_id: int, author: str = "Unknown", published_year: Optional[int] = None):
    return {
        "book_id": book_id,
        "author": author,
        "published_year": published_year
    }

Which of the following URLs would successfully call this endpoint and return a published_year?

Recap: Dynamic API Routes

Great work! You made routes dynamic with path parameters for required IDs, query parameters for optional filters, and type hints for free validation.

Questions Fréquemment Posées

La leçon « Paramètres de chemin et de requête » est-elle gratuite ?

Oui — le texte complet de « Paramètres de chemin et de requête » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours FastAPI Backend Development Bootcamp, passe à CoddyKit PRO. Le cours FastAPI Backend Development Bootcamp comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Paramètres de chemin et de requête » ?

Découvrez comment extraire des données dynamiques des URL à l’aide de paramètres de chemin et traiter des paramètres de requête facultatifs. Tu pratiques FastAPI Backend Development Bootcamp avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer FastAPI Backend Development Bootcamp ?

Aucune expérience préalable n'est requise. FastAPI Backend Development Bootcamp sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 3 sur 4.

Combien de temps prend la leçon « Paramètres de chemin et de requête » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon FastAPI Backend Development Bootcamp ?

Oui. Chaque leçon FastAPI Backend Development Bootcamp inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

Introduction à FastAPI et configuration
Votre premier point d’accès d’API
Paramètres de chemin et de requête
Documentation interactive de l’API avec Swagger UI

← Retour à FastAPI Backend Development Bootcamp