Серверная разработка, данные и API

Серверные приложения, базы данных, авторизация и интеграции.

Темы раздела

Материалы

• Поисковый сервис и API

  Как подготовить версионный индекс Meilisearch, дождаться задач и прочитать ответ поискового API.

• Надёжность поискового сервиса

  Как ограничить поисковый API, сохранить ключи на сервере и наблюдать ошибки без записи полных запросов.

• HTTP-запрос и ответ

  Разбираем запрос и ответ каталога: адрес, метод, заголовки, тело и границы учебной модели.

• Методы и смысл операции

  Выбираем GET, HEAD, POST, PUT и DELETE по смыслу операции на одном каталоге.

• Коды состояния ответа

  Согласуем 200, 201, 204, 400, 404, 409, 422 и 5xx с конкретным исходом операции.

• Заголовки и метаданные сообщения

  Читаем Content-Type, Accept, Location, Allow, Cache-Control, Vary и ETag по их роли.

• Представление ресурса

  Различаем курс, его постоянный адрес, JSON, HTML и редактируемое представление.

• Согласование формата ответа

  Выбираем JSON или HTML через Accept, учитываем q=0, Vary и различие 406/415.

• Контракт JSON API

  Определяем обязательные поля, типы JSON, различие null и пропуска, вход и совместимость ответа.

• Путь и параметры запроса

  Разделяем адрес записи и параметры выборки, кодируем значения и объявляем ошибки query.

• Проверка входного запроса

  Проверяем тип и синтаксис входа, поля и диапазоны до изменения каталога.

• Единая форма ошибок API

  Проектируем Problem Details: type, title, status, detail, instance и собственные ошибки полей.

• Идемпотентность операций

  Различаем повторяемый эффект и одинаковый ответ, безопасное чтение и повтор POST.

• Ключ повторяемой операции

  Проектируем прикладной Idempotency-Key: намерение, область, отпечаток, атомарность и срок результата.

• Контракт пагинации API

  Строим устойчивую пагинацию: полный порядок, непрозрачный курсор и ограниченный снимок.

• Фильтрация и сортировка API

  Определяем последовательность фильтрации, полного порядка и пагинации без произвольных выражений.

• Условные GET-запросы

  Сохраняем представление с ETag и проверяем его через If-None-Match без тела в 304.

• Условное изменение ресурса

  Защищаем PUT и DELETE сильным If-Match, различаем 428/412 и атомарно меняем версию.

• Варианты кешируемого ответа

  Разделяем публичный кеш, варианты представления и персональный ответ без смешивания пользователей.

• Cookies в HTTP

  Определяем host-only cookie, Path, Secure, HttpOnly, SameSite и удаление сессионного идентификатора.

• Сессия и состояние клиента

  Разделяем cookie, серверную запись сессии, сроки, ротацию, отзыв и CSRF-токен.

• Аутентификация в контракте API

  Согласуем session cookie и Bearer как альтернативы, 401 challenge и безопасный отказ без HTML-редиректа.

• Права на ресурс

  Проверяем действие и область курса после установления личности, включая перенос между темами.

• Граница origin и CORS

  Различаем origin и site, preflight и фактический запрос, CORS и серверное разрешение.