Какие типы полей доступны в сериализаторах Django REST Framework?

Ну, слушай, сядь-ка, я тебе сейчас про сериализаторы в DRF так расскажу, что ты, блядь, сам начнёшь их во сне видеть. Это ж, ёпта, как переводчик для твоих моделей — берёт их, эти, заумные штуки из базы, и делает из них понятный JSON, чтобы браузер не охуел.

Вот представь, у тебя есть модель User. В базе она лежит, как здоровенный лось, а фронтенд-разработчик, этот, с бантиком, кричит: «Дай мне данные, но только красиво!». Вот тут-то сериализатор и выходит на сцену, как этот, Герасим, только не топит, а наоборот, вытаскивает.

1. Поля модели (Model Fields) Это когда ты ленивый, как манда с ушами, и хочешь, чтобы всё само сделалось. Берёшь ModelSerializer, и он, сука, сам всё сопоставляет. Магия, блядь!

from rest_framework import serializers
from .models import User

class UserSerializer(serializers.ModelSerializer):
    class Meta:
        model = User
        fields = ['id', 'username', 'email'] # Смотри-ка, всё автоматом! Ёперный театр!

2. Базовые поля (Base Fields) А вот это когда ты — художник и хочешь всё контролировать. Сам объявляешь каждое поле, как генерал войска.

class ProductSerializer(serializers.Serializer):
    name = serializers.CharField(max_length=100, help_text="Название продукта, дурик, не опечатайся")
    price = serializers.DecimalField(max_digits=10, decimal_places=2) # Цена, чтоб не обманули
    is_available = serializers.BooleanField(default=True) # Есть в наличии или уже всё разобрали пидары
    created_at = serializers.DateTimeField(read_only=True) # Это только читать, не трогай!

3. Специальные поля (Special Fields) А вот тут начинается цирк, блядь. Например, SerializerMethodField. Это когда тебе нужно выдать какую-то хуйню, которой в модели нет в чистом виде.

class UserSerializer(serializers.ModelSerializer):
    full_name = serializers.SerializerMethodField() # Поле из воздуха, блядь!

    def get_full_name(self, obj):
        # Берём объект и лепим из него что хотим
        return f"{obj.first_name} {obj.last_name}" # Имя и фамилия вместе, красота!

А ещё есть поля для связей: PrimaryKeyRelatedField (просто ID), SlugRelatedField (по какому-то другому полю, не ID), HyperlinkedRelatedField (вообще ссылку даёт, чтоб прям по REST-ам ходить).

4. Вложенные сериализаторы (Nested Serializers) Это, сука, самый сок! Когда ты в данные одного объекта засовываешь данные другого, связанного. Как матрёшка, блядь.

class ProfileSerializer(serializers.ModelSerializer):
    class Meta:
        model = Profile
        fields = ['bio', 'location'] # Описание и город, где живёт этот чувак

class UserSerializer(serializers.ModelSerializer):
    profile = ProfileSerializer() # БАЦ! И профиль сразу внутри пользователя лежит!
    class Meta:
        model = User
        fields = ['id', 'username', 'email', 'profile'] # Всё в одной куче, удобно, на хуй!

Только осторожно, а то так глубоко закопаешься, что сам не вылезешь. N+1 проблему можешь получить — запросов в базу будет, как говна за баней.

5. Кастомные поля (Custom Fields) Ну а если ты совсем ебнулся и стандартного тебе мало — делай своё. Наследуйся от serializers.Field и делай что в голову взбредёт. Хоть шифруй, хоть в BASE64 кодируй.

Общие параметры — они как специи Их, блядь, куда хочешь можно пихать:

• required=False — сделаешь необязательным, и если не прислали — не будет скандала.
• read_only=True — только для чтения, как мемуары деда. При создании объекта его игнорят.
• write_only=True — наоборот, только для приёма пароля, например, а в ответ его не показывают.
• source='field_name' — о, это хитрая жопа! Если в сериализаторе поле назвал fullName, а в модели оно full_name, то через source их подружишь.
• help_text — это чтоб в сваггере (этой документации API) было понятно, что за поле. Типа подсказка для тех, кто в танке.

Вот и вся философия. Сначала кажется, что овердохуища всего, но потом привыкаешь. Главное — не пытайся всё сразу впихнуть во вложенные сериализаторы, а то сервер ляжет, и будет тебе пиздец, а не API.