Для чего используются параметры запроса (query-параметры) в Django, FastAPI и других фреймворках

Query-параметры позволяют передавать данные в URL после знака ? в формате ключ=значение. Они используются для:

1. Фильтрации данных – например, /api/users?role=admin
2. Сортировки – /api/products?sort=price&order=desc
3. Пагинации – /api/posts?page=2&limit=10
4. Поиска – /api/books?q=python
5. Опциональных параметров – /api/weather?units=metric

Пример в FastAPI:

from fastapi import FastAPI, Query

app = FastAPI()

@app.get("/items/")
async def read_items(q: str = Query(None, min_length=3)):
    return {"q": q}

В Django:

from django.http import JsonResponse

def my_view(request):
    search_term = request.GET.get('q', '')
    return JsonResponse({"q": search_term})

Query-параметры удобны тем, что:

• Сохраняют состояние URL
• Позволяют делиться ссылками с параметрами
• Не требуют изменения маршрутов