🌐 REST API
11 статей
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 и Stateful API: полный разбор с примерами и таблицей сравнения
Полный разбор stateless и stateful API: что хранится в состоянии, диаграммы потоков, когда что выбирать, таблица сравнения и влияние на масштабирование
Stateless и Stateful: примеры, отличия и когда что использовать
Stateless и stateful простыми словами: чем отличаются, как выбрать, реальные примеры из REST API, банкинга и e-commerce, а также подробная таблица сравнения для системного аналитика.
HTTP коды ответов: полный справочник для разработчика и аналитика
HTTP статус коды простыми словами: что означают 1xx, 2xx, 3xx, 4xx и 5xx, чем 401 отличается от 403, когда возвращать 422, а когда 400, и как правильно проектировать коды ошибок REST API.
OAuth и JWT для REST API: авторизация на пальцах
Как работает OAuth 2.0 и JWT токены в REST API — разбираем flow авторизации, access и refresh токены, типичные ошибки и примеры для системного аналитика
Swagger и OpenAPI: как писать документацию API, которую читают
Подробный гид по Swagger и OpenAPI 3.0 — чем отличаются, как писать спецификацию API, которую действительно читают разработчики, QA и аналитики, с примерами, диаграммой и типичными ошибками
Правила названий ручек (endpoint)
Основные правила нейминга endpoint ручек со ссылками на RFC документы
Rest api: Основные принципы
Чек-лист основных правил проектирования REST API: как называть endpoint, использовать HTTP методы и избегать типичных ошибок
Stateless и Stateful: разница на примерах REST API
Чем stateless отличается от stateful (statefull) в REST API: простое объяснение, примеры и влияние на масштабирование.