Как получить объект по ID в Django Rest Framework?

# campaigns/views.py
from rest_framework import generics
from django.contrib.auth.models import User # Пример модели
from .models import Campaign
from .serializers import CampaignSerializer
from typing import Any

class CampaignDetailView(generics.RetrieveAPIView):
    """
    Представление для получения детальной информации
    о конкретной рекламной кампании по её ID.
    """
    queryset = Campaign.objects.all() # Базовый набор данных
    serializer_class = CampaignSerializer
    # lookup_field = 'pk' # По умолчанию 'pk', можно изменить на 'id', 'slug' и т.д.

    def get_queryset(self) -> models.QuerySet[Campaign]:
        """Возвращает кампании, доступные текущему пользователю."""
        user: User = self.request.user
        if user.is_staff:
            return Campaign.objects.all()
        # Пример: возвращаем только кампании, созданные пользователем
        # return Campaign.objects.filter(created_by=user)
        # В данном примере для простоты вернем все
        return super().get_queryset()

# campaigns/serializers.py
from rest_framework import serializers
from .models import Campaign

class CampaignSerializer(serializers.ModelSerializer):
    """
    Сериализатор для модели Campaign.
    """
    class Meta:
        model = Campaign
        fields: list[str] = ['id', 'name', 'budget', 'start_date', 'end_date', 'status', 'created_at']
        # Или fields = '__all__' для включения всех полей
        read_only_fields: list[str] = ['id', 'created_at'] # Поля только для чтения

# campaigns/urls.py
from django.urls import path
from .views import CampaignDetailView

urlpatterns = [
    # URL для получения конкретной кампании по её ID (целое число)
    path('campaigns//', CampaignDetailView.as_view(), name='campaign-detail'),
]

# marketing_data/views.py
from rest_framework import viewsets, permissions
from .models import AdGroup
from .serializers import AdGroupSerializer
from typing import Any

class AdGroupViewSet(viewsets.ReadOnlyModelViewSet): # Или ModelViewSet для CRUD
    """
    ViewSet для просмотра групп объявлений.
    Предоставляет действия 'list' и 'retrieve'.
    """
    queryset = AdGroup.objects.select_related('campaign').all() # Оптимизация запроса
    serializer_class = AdGroupSerializer
    permission_classes: list[Any] = [permissions.IsAuthenticated] # Пример ограничения доступа

    # Можно переопределить get_queryset для фильтрации по пользователю и т.д.
    # def get_queryset(self):
    #     ...

# project/urls.py (основной файл URL)
from django.urls import path, include
from rest_framework.routers import DefaultRouter
from marketing_data.views import AdGroupViewSet

# Создаем экземпляр роутера
router = DefaultRouter()

# Регистрируем ViewSet. 'adgroups' - префикс URL, 'adgroup' - базовое имя для генерации имен URL
router.register(r'adgroups', AdGroupViewSet, basename='adgroup')

urlpatterns = [
    # ... другие URL вашего проекта
    path('api/', include(router.urls)), # Подключаем URL, сгенерированные роутером
]

# marketing_data/views.py
# ... (импорты)
from django.shortcuts import get_object_or_404

class AdGroupViewSet(viewsets.ReadOnlyModelViewSet):
    # ... (queryset, serializer_class, etc.)

    def get_object(self) -> AdGroup:
        """
        Возвращает объект группы объявлений.
        Переопределено для возможной кастомной логики.
        """
        queryset = self.filter_queryset(self.get_queryset())
        lookup_url_kwarg = self.lookup_url_kwarg or self.lookup_field

        assert lookup_url_kwarg in self.kwargs, (
            f'Expected view {self.__class__.__name__} to be called with a URL keyword '
            f'argument named "{lookup_url_kwarg}". Fix your URL conf.'
        )

        filter_kwargs = {self.lookup_field: self.kwargs[lookup_url_kwarg]}
        obj = get_object_or_404(queryset, **filter_kwargs)

        # Проверяем права доступа к объекту
        self.check_object_permissions(self.request, obj)

        # Здесь можно добавить кастомную логику перед возвратом объекта
        # Например, логирование доступа или дополнительные проверки

        return obj

# reports/views.py
from rest_framework.views import APIView
from rest_framework.response import Response
from rest_framework import status, permissions
from django.shortcuts import get_object_or_404
from .models import DailyReport
from .serializers import DailyReportSerializer
from rest_framework.request import Request
from typing import Any

class DailyReportDetailView(APIView):
    """
    Ручное представление для получения отчета по ID.
    """
    permission_classes: list[Any] = [permissions.IsAdminUser] # Доступ только для администраторов

    def get(self, request: Request, pk: int, format: str = None) -> Response:
        """
        Обрабатывает GET-запрос для получения отчета.

        Args:
            request: Объект запроса DRF.
            pk: ID отчета, извлеченный из URL.
            format: Опциональный параметр формата ответа.

        Returns:
            Объект Response с данными отчета или ошибкой.
        """
        report: DailyReport = self.get_object(pk)
        serializer = DailyReportSerializer(report)
        return Response(serializer.data, status=status.HTTP_200_OK)

    def get_object(self, pk: int) -> DailyReport:
        """
        Вспомогательный метод для получения объекта или выброса 404.
        """
        try:
            # Можно добавить фильтрацию по пользователю или другие условия
            return get_object_or_404(DailyReport, pk=pk)
        except DailyReport.DoesNotExist:
            # get_object_or_404 сам выбросит Http404, но можно кастомизировать
            raise Http404

# Альтернатива с использованием @api_view
from rest_framework.decorators import api_view, permission_classes

@api_view(['GET'])
@permission_classes([permissions.IsAdminUser])
def daily_report_detail(request: Request, pk: int) -> Response:
    """
    Функциональное представление для получения отчета по ID.
    """
    report: DailyReport = get_object_or_404(DailyReport, pk=pk)
    serializer = DailyReportSerializer(report)
    return Response(serializer.data)

# Пример с кэшированием (требует настройки кэша в Django)
from django.core.cache import cache
from django.conf import settings

# Внутри метода get представления:
def get(self, request: Request, pk: int, format: str = None) -> Response:
    cache_key = f'report_detail_{pk}'
    cached_data = cache.get(cache_key)
    if cached_data:
        return Response(cached_data, status=status.HTTP_200_OK)

    report: DailyReport = self.get_object(pk)
    serializer = DailyReportSerializer(report)
    cache.set(cache_key, serializer.data, timeout=settings.CACHE_TTL)
    return Response(serializer.data, status=status.HTTP_200_OK)

# В ViewSet или Generic View
def get_queryset(self):
    # Загружаем связанную кампанию одним JOIN-запросом
    # Загружаем связанные ключевые слова отдельным запросом для всех групп
    return AdGroup.objects.select_related('campaign').prefetch_related('keywords').all()