Первая программа на Django REST Framework

ОБЯЗАТЕЛЬНОДЛЯ НОВИЧКОВ

Разработчику

Загрузка симулятора первой программы…

Первая программа на Django REST Framework

От HTML к JSON

Первая программа на Django заканчивается HTML-страницей в браузере и админкой /admin. В реальных проектах тот же бэкенд часто отдаёт JSON — текстовый формат, который удобно читать JavaScript, мобильным приложениям и другим сервисам.

Пример JSON-ответа:

[
  {"id": 1, "text": "Купить молоко", "created_at": "2026-05-26T10:00:00Z"}
]

Django REST Framework (DRF) — надстройка над Django, которая превращает модели БД в такой API с минимумом кода.

Если проект ещё не на Django и нужен только API — смотрите FastAPI. DRF выигрывает, когда уже есть Django: ORM, auth, админка, одна кодовая база.

---

Словарь DRF

Термин	Простыми словами
API	Набор URL, по которым клиент получает и меняет данные
Сериализатор	Класс: «какие поля модели уйти в JSON» + проверка входа
ViewSet	Один класс с методами list, create, retrieve, update, destroy
Router	Автоматически создаёт URL вроде /api/notes/ и /api/notes/1/
Browsable API	HTML-страница DRF для ручной отладки POST/GET в браузере
QuerySet	«Запрос к БД», который Django выполнит позже: Note.objects.all()

---

Что получится

Метод HTTP	URL	Действие
GET	/api/notes/	Список заметок
POST	/api/notes/	Создать: тело {"text": "..."}
GET	/api/notes/1/	Одна заметка с id=1
PUT/PATCH	/api/notes/1/	Изменить (ModelViewSet умеет)
DELETE	/api/notes/1/	Удалить

Слэш в конце URL (/notes/) — важная деталь Django: без него часто будет редирект 301.

---

Подготовка проекта

Продолжите проект из 3011.md или создайте новый:

python -m venv venv
# Windows — venv\Scripts\activate
# macOS/Linux — source venv/bin/activate

pip install django djangorestframework
django-admin startproject notes_project
cd notes_project
python manage.py startapp notes

startproject — каркас с settings.py и urls.py. startapp notes — приложение с models.py, куда кладут модель «Заметка».

Регистрация в settings.py

INSTALLED_APPS = [
  # ...
  'rest_framework',
  'notes',
]

Django подхватывает только приложения из этого списка. Без 'rest_framework' импорты from rest_framework import ... упадут с ModuleNotFoundError.

---

Модель — что хранится в БД

notes/models.py:

from django.db import models

class Note(models.Model):
    text = models.CharField(max_length=500)
    created_at = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return self.text[:50]

Поле	Смысл
CharField(max_length=500)	Строка до 500 символов
DateTimeField(auto_now_add=True)	Время создания ставится один раз при INSERT
__str__	Как запись выглядит в админке

Создание таблиц в БД:

python manage.py makemigrations   # файл миграции в git
python manage.py migrate          # применить к SQLite/PostgreSQL

Миграция — версионированное изменение схемы. Вы изменили модель — снова makemigrations + migrate.

---

Сериализатор — мост модель ↔ JSON

notes/serializers.py:

from rest_framework import serializers
from .models import Note

class NoteSerializer(serializers.ModelSerializer):
    class Meta:
        model = Note
        fields = ['id', 'text', 'created_at']
        read_only_fields = ['id', 'created_at']

Разбор:

• ModelSerializer — DRF сам построит поля по модели Note.
• fields — белый список: в JSON попадут только эти ключи.
• read_only_fields — клиент при POST не может подставить свой id или created_at; сервер выставит сам.

При POST с пустым text DRF вернёт 400 с описанием полей — отдельный if not text в каждом view писать не нужно.

Пример ошибки:

{"text": ["This field may not be blank."]}

---

ViewSet — вся CRUD-логика в одном классе

notes/views.py:

from rest_framework import viewsets
from .models import Note
from .serializers import NoteSerializer

class NoteViewSet(viewsets.ModelViewSet):
    queryset = Note.objects.all().order_by('-created_at')
    serializer_class = NoteSerializer

Атрибут	Смысл
queryset	Откуда брать объекты для list/retrieve/update/delete
order_by('-created_at')	Сначала новые заметки
ModelViewSet	Включает list, create, retrieve, update, partial_update, destroy

Раньше в «голом» Django писали отдельную функцию на каждое действие. ViewSet группирует их по ресурсу Note.

---

Router — автоматические URL

notes_project/urls.py:

from django.contrib import admin
from django.urls import path, include
from rest_framework.routers import DefaultRouter
from notes.views import NoteViewSet

router = DefaultRouter()
router.register('notes', NoteViewSet, basename='note')

urlpatterns = [
    path('admin/', admin.site.urls),
    path('api/', include(router.urls)),
]

router.register('notes', ...) создаёт маршруты:

• GET/POST → /api/notes/
• GET/PUT/PATCH/DELETE → /api/notes/<pk>/

basename='note' — имя для reverse в тестах (reverse('note-list')).

---

Запуск и проверка

python manage.py runserver

В браузере (Browsable API)

Откройте http://127.0.0.1:8000/api/notes/ — форма DRF: можно отправить POST с полем text без Postman.

curl — как это видит скрипт

Список:

curl http://127.0.0.1:8000/api/notes/

Создание:

curl -X POST http://127.0.0.1:8000/api/notes/ \
  -H "Content-Type: application/json" \
  -d "{\"text\": \"Первая заметка через DRF\"}"

Часть команды	Смысл
-X POST	Метод HTTP
Content-Type: application/json	Тело — JSON
-d "{...}"	Тело запроса

Ответ при успехе — 201 Created и JSON с id, text, created_at.

---

Разрешения (важно для production)

По умолчанию настройки DRF могут требовать авторизацию. Для локальной отладки иногда явно разрешают всем:

REST_FRAMEWORK = {
    'DEFAULT_PERMISSION_CLASSES': [
        'rest_framework.permissions.AllowAny',
    ],
}

Для боевого API замените на IsAuthenticated и подключите сессии Django, токены или JWT (djangorestframework-simplejwt). Иначе любой в интернете сможет читать и удалять ваши данные.

---

Как DRF связан с обычным Django

Слой	Обычный Django (3011)	DRF
Данные	models.Model	Та же модель
Ответ	HTML-шаблон	JSON через сериализатор
Вход формы	request.POST	JSON в request.data
URL	path('...', view)	Router + ViewSet

Фронт на React делает fetch('/api/notes/') и рисует список без серверного HTML.

---

Частые ошибки

Симптом	Причина	Решение
404 на /api/notes	Нет завершающего /	Запрос на /api/notes/
Пустой список после POST	POST на неверный URL или 400	Смотреть тело ответа и статус
ModuleNotFoundError: rest_framework	Не в INSTALLED_APPS	Добавить приложение
403 Forbidden	Строгие permissions	AllowAny локально или login

---

Что попробовать дальше

1. SearchFilter — GET /api/notes/?search=молоко.
2. PageNumberPagination — постраничный список в REST_FRAMEWORK.
3. Сравнить тот же сценарий «заметки» с Flask и FastAPI.
4. Тесты API — pytest + APIClient из DRF.

---

Связанные материалы

• Django · справочник Django (раздел DRF)
• Создание API на Python
• FastAPI
• Первая программа на Django
• Работа с базами данных в Python

---