HTTP и проектирование API
Новые курсы · Опубликованные курсы
32 урока о договоре клиента и сервера: сообщения, JSON, ошибки, повторяемость, пагинация, условия записи, сессии, CORS, файлы, фоновые операции и вебхуки.
Команды, учебные программы и измерения не выполнялись; результаты примеров описаны как ожидаемые.
Перед началом
Полезно понимать URL и JSON. В первой части определяется каталог, во второй сохраняются его данные и добавляются права, браузерный контекст и жизненный цикл операций.
Уроки 1–16
- HTTP-запрос и ответ
- Методы HTTP: смысл GET, POST и изменений ресурса
- Коды состояния HTTP: ответы сервера
- HTTP-заголовки: метаданные запроса и ответа
- HTTP API: представление ресурса
- Content negotiation в HTTP: выбор формата ответа
- Контракт JSON API
- HTTP API: путь и параметры запроса
- HTTP API: проверка входного запроса
- Ошибки HTTP API: единый формат ответа
- Идемпотентность HTTP API: повтор операции
- Idempotency key в API: ключ повторяемой операции
- Контракт пагинации API
- Фильтрация и сортировка API
- Условные GET-запросы HTTP и валидация кеша
- Условное обновление HTTP-ресурса: защита от конфликтов
Новые уроки 17–32
- HTTP API: варианты кешируемого ответа
- Cookies в HTTP
- HTTP API: сессия и состояние клиента
- Аутентификация в контракте API
- HTTP API: права на ресурс
- CORS в HTTP API: origin и доступ браузера
- HTTP API: запросы с cookies и CSRF
- HTTP API: контракт загрузки файлов
- HTTP Range: частичная передача ресурса
- Перенаправления HTTP
- Rate limiting в HTTP API: ограничение запросов
- Асинхронная операция API
- Webhooks: контракт доставки и повторные уведомления
- Описание контракта OpenAPI
- Совместимое изменение API
- Разбор API перед выпуском
Учебные исходники
Исходники уроков 1–16 · Исходники продолжения.
В архивах находятся исходные состояния, ожидаемые результаты и условия самостоятельного прохождения. Наличие примера не означает, что его исполнение уже подтверждено.