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