🌐 REST API
6 статей
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 и Statefull на пальцах
Объяснение принципов stateless и stateful в REST API на простых примерах