Когда лучше использовать APIView для построения API в Django?

Когда использовать APIView

APIView — это базовый класс Django REST Framework для создания API endpoints. Вот основные сценарии его использования:

1. Нетипичная бизнес-логика

Когда нужна логика, которая не укладывается в стандартный CRUD паттерн:

from rest_framework.views import APIView
from rest_framework.response import Response
from rest_framework import status

class UploadBulkDataView(APIView):
    permission_classes = [IsAuthenticated]
    
    def post(self, request):
        file = request.FILES.get("file")
        if not file:
            return Response(
                {"error": "No file provided"}, 
                status=status.HTTP_400_BAD_REQUEST
            )
        
        # Кастомная обработка файла
        try:
            processed_data = process_csv(file)
            save_to_db(processed_data)
            return Response(
                {"imported": len(processed_data)},
                status=status.HTTP_201_CREATED
            )
        except ValueError as e:
            return Response({"error": str(e)}, status=status.HTTP_400_BAD_REQUEST)

2. Полный контроль над обработкой запроса

Когда нужна детальная настройка каждого HTTP метода:

class ComplexResourceView(APIView):
    def get(self, request, pk):
        # Сложная логика выборки с множеством условий
        resource = get_complex_resource(pk, request.user)
        return Response(ResourceSerializer(resource).data)
    
    def patch(self, request, pk):
        # Частичное обновление с валидацией
        resource = get_object_or_404(Resource, pk=pk)
        serializer = ResourceSerializer(resource, data=request.data, partial=True)
        if serializer.is_valid():
            serializer.save()
            return Response(serializer.data)
        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
    
    def delete(self, request, pk):
        # Мягкое удаление с логированием
        resource = get_object_or_404(Resource, pk=pk)
        resource.soft_delete()
        return Response(status=status.HTTP_204_NO_CONTENT)

3. Интеграция с внешними сервисами

Когда нужна гибкость для работы с третьим API:

class PaymentWebhookView(APIView):
    permission_classes = [AllowAny]
    
    def post(self, request):
        signature = request.headers.get("X-Signature")
        payload = request.data
        
        # Верификация подписи
        if not verify_webhook_signature(payload, signature):
            return Response({"error": "Invalid signature"}, status=status.HTTP_401_UNAUTHORIZED)
        
        # Обработка платежа
        transaction = handle_payment(payload)
        notify_user(transaction)
        
        return Response({"status": "processed"})

4. Различные форматы ответов

Когда нужны разные форматы в зависимости от параметров:

class ExportView(APIView):
    def get(self, request):
        format_type = request.query_params.get("format", "json")
        data = get_report_data()
        
        if format_type == "csv":
            return generate_csv_response(data)
        elif format_type == "excel":
            return generate_excel_response(data)
        else:
            return Response(data)

APIView vs ViewSets — выбор

Используй APIView когда:

• Логика не укладывается в CRUD
• Нужна максимальная гибкость
• Разные методы имеют совершенно разную логику
• Кастомная аутентификация/авторизация

Используй ViewSets когда:

• Стандартный CRUD
• Нужна консистентность в API
• Хочешь минимизировать код
• Нужна автоматическая документация

Преимущества APIView

✓ Полная свобода в реализации ✓ Понятный код — методы соответствуют HTTP методам ✓ Легко отладить ✓ Минимум "магии" ✓ Отличный выбор для вспомогательных endpoints

APIView — это правильный выбор, когда стандартные решения не подходят и нужна полная кастомизация.