Перейти к содержанию

HTTP и проектирование API

Новые курсы · Опубликованные курсы

32 урока о договоре клиента и сервера: сообщения, JSON, ошибки, повторяемость, пагинация, условия записи, сессии, CORS, файлы, фоновые операции и вебхуки.

Команды, учебные программы и измерения не выполнялись; результаты примеров описаны как ожидаемые.

Перед началом

Полезно понимать URL и JSON. В первой части определяется каталог, во второй сохраняются его данные и добавляются права, браузерный контекст и жизненный цикл операций.

Уроки 1–16

  1. HTTP-запрос и ответ
  2. Методы HTTP: смысл GET, POST и изменений ресурса
  3. Коды состояния HTTP: ответы сервера
  4. HTTP-заголовки: метаданные запроса и ответа
  5. HTTP API: представление ресурса
  6. Content negotiation в HTTP: выбор формата ответа
  7. Контракт JSON API
  8. HTTP API: путь и параметры запроса
  9. HTTP API: проверка входного запроса
  10. Ошибки HTTP API: единый формат ответа
  11. Идемпотентность HTTP API: повтор операции
  12. Idempotency key в API: ключ повторяемой операции
  13. Контракт пагинации API
  14. Фильтрация и сортировка API
  15. Условные GET-запросы HTTP и валидация кеша
  16. Условное обновление HTTP-ресурса: защита от конфликтов

Новые уроки 17–32

  1. HTTP API: варианты кешируемого ответа
  2. Cookies в HTTP
  3. HTTP API: сессия и состояние клиента
  4. Аутентификация в контракте API
  5. HTTP API: права на ресурс
  6. CORS в HTTP API: origin и доступ браузера
  7. HTTP API: запросы с cookies и CSRF
  8. HTTP API: контракт загрузки файлов
  9. HTTP Range: частичная передача ресурса
  10. Перенаправления HTTP
  11. Rate limiting в HTTP API: ограничение запросов
  12. Асинхронная операция API
  13. Webhooks: контракт доставки и повторные уведомления
  14. Описание контракта OpenAPI
  15. Совместимое изменение API
  16. Разбор API перед выпуском

Учебные исходники

Исходники уроков 1–16 · Исходники продолжения.

В архивах находятся исходные состояния, ожидаемые результаты и условия самостоятельного прохождения. Наличие примера не означает, что его исполнение уже подтверждено.

Все новые курсы · Каталог сайта