🌐 REST API
15 статей
Пагинация, фильтрация и сортировка в REST API: как проектировать выборки
Проектирование пагинации, фильтрации и сортировки в REST API: offset vs cursor, синтаксис фильтров, сортировка по нескольким полям, антипаттерны и чек-лист для аналитика
Версионирование REST API: URL, заголовки, стратегии эволюции
Как версионировать REST API правильно: сравнение URL-подхода, заголовков и content negotiation, стратегия обратной совместимости, депрекация через Sunset и чек-лист для аналитика
REST API: основные принципы — полный разбор
Полный разбор 6 принципов REST API: клиент-сервер, отсутствие состояния, кешируемость, многослойность, единообразие интерфейса и код по требованию. С примерами для системных аналитиков и разработчиков.
Идемпотентность в REST API: что это простыми словами и как защитить платежи от дублей
Идемпотентность API на пальцах: какие HTTP-методы идемпотентны, как работает ключ идемпотентности и как не допустить двойного списания денег — с примерами на платежах.
HTTP-методы REST API: GET, POST, PUT, PATCH, DELETE — когда какой применять
Полный разбор HTTP-методов REST API: семантика GET, POST, PUT, PATCH и DELETE, безопасность и идемпотентность, таблица сравнения и типичные ошибки при выборе метода.
Что такое «ручка» (endpoint) в API: объясняем простыми словами
Разбираем, что такое ручка (endpoint) в REST API, откуда взялся этот жаргон, чем endpoint отличается от HTTP-метода — с примерами, диаграммой и таблицей сравнения
gRPC vs REST vs GraphQL: что выбрать аналитику при проектировании
Сравнение gRPC, REST и GraphQL для системного аналитика: матрица выбора протокола под бизнес-сценарии, таблица сравнения, дерево принятия решений, Protobuf-контракты, влияние на архитектуру и практические рекомендации.
Stateless vs Stateful API: в чём разница и как выбрать — полный разбор
Stateless и stateful API простыми словами: где хранить сессию, как масштабировать каждый подход, таблица сравнения и чёткий алгоритм выбора для вашего проекта.
Stateless и Stateful: примеры, отличия и когда что использовать
Stateless и stateful простыми словами: чем отличаются, как выбрать, реальные примеры из REST API, банкинга и e-commerce, а также подробная таблица сравнения для системного аналитика.
HTTP коды ответов: полный справочник с примерами (1xx–5xx)
Все HTTP статус коды простыми словами: что означают 1xx, 2xx, 3xx, 4xx и 5xx, чем 401 отличается от 403, когда 400, а когда 422 — таблицы и примеры для REST API.
OAuth и JWT для REST API: авторизация на пальцах
Как работает OAuth 2.0 и JWT токены в REST API — разбираем flow авторизации, access и refresh токены, типичные ошибки и примеры для системного аналитика
Swagger и OpenAPI: в чём разница и как писать документацию API (гайд 2026)
Swagger vs OpenAPI 3.0: чем отличаются, как написать спецификацию API с примерами, которую читают разработчики и QA — пошаговый гид с диаграммой и типичными ошибками.
Правила названий ручек (endpoint)
Основные правила нейминга endpoint ручек со ссылками на RFC документы
Rest api: Основные принципы
Чек-лист основных правил проектирования REST API: как называть endpoint, использовать HTTP методы и избегать типичных ошибок
Stateless и Stateful: разница на примерах REST API
Чем stateless отличается от stateful (statefull) в REST API: простое объяснение, примеры и влияние на масштабирование.