GET, POST, PUT, PATCH и DELETE - виды методов, часть протокола HTTP. Используются в архитектурном стиле REST API.
Нужны, чтобы стандартизировать взаимодействие между клиентом и сервером.
Каждый метод выполняет определённое действие и соответствует логике CRUD-модели (Create, Read, Update, Delete).
🩷 GET - Чтение данных
Не поддерживает тело - Body (JSON).
Идемпотентен.
💚 POST - Создание ресурсов (объектов в БД)
Поддерживает тело - Body (JSON).
Не идемпотентен.
* Исключения, когда POST используют для чтения: сложные запросы с большим кол-вом фильтров, асинхронные операции.
** Почему в некоторых REST API все POST? Потому что они не REST API, а HTTP API.
💙 PUT - Полная замена и/или создание ресурса
В теле JSON требует полный объект.
Идемпотентен.
* Часто используют только для изменения.
💜 PATCH - Частичное обновление ресурса
В теле JSON передаются только те поля объекта, которые нужно изменить.
Не идемпотентен.
❤️ DELETE - Удаление ресурса.
Не поддерживает тело - Body (JSON).
Идемпотентен.
💛 А что по поводу TRACE, HEAD, OPTIONS, CONNECT?
Могут быть заменены GET-ом.
Очень маленький шанс встретить или применить на практике.
Правильное использование HTTP-методов в REST API упрощает взаимодействие с вашей системой, так как делает API предсказуемым и удобным для разработчиков.
P.S. Ссылка на подкаст про идемпотентность и коммутативность в API
#hardGetAnalyst
Please open Telegram to view this post
VIEW IN TELEGRAM
Please open Telegram to view this post
VIEW IN TELEGRAM
❤12
REST_API_Пример_требований_Создать_товар_POST_GetAnalyst.pdf
1.1 MB
📚 Заполненный шаблон задачи на REST API - создание товара через POST /products 📚
Ключевые REST API методы:
✅ Поиск по каталогу продуктов (с кэшированием)
Выгрузка требований из Confluence
✅ Редактирование товара для фермера
Выгрузка требований из Confluence
✅ Создание заказа
Финальная выгрузка из Confluence добавлена к этому посту.
На что стоит обратить внимание в этой базе документации:
👉 1. Использование метода POST как на создание, так и на получение данных. Хотя POST в REST предназначен только для создания.
👉 2. PUT на редактирование товара с обоснованием, почему мы всегда хотим отправлять на сервер полный набор параметров, а не только изменённые - что можно делать в PATCH.
👉 3. Наличие нескольких каталогов API на сервере:
+ Поиск продуктов - public
+ Редактирование и создание продуктов - seller-api
Обратите внимание на разницу в полных URL.
👉 4. Оформление требований к обработке ошибок.
👉 5. Алгоритм кэширования в поиске товаров по каталогу.
👉 6. Примеры требований к логированию и мониторигу.
👉 7. Наличие макетов UI и схемы БД, которые были необходимы для работы.
Эти документы — одновременно:
◽️ реальные примеры с проектов,
◽️ решения задач с собеседований на Senior СА (особенно метод поиска с кэшированием).
Сохраняйте подборку в избранное и делитесь с коллегами ❤️🔥
#hardGetAnalyst
Ключевые REST API методы:
✅ Поиск по каталогу продуктов (с кэшированием)
POST /products/search
Выгрузка требований из Confluence
✅ Редактирование товара для фермера
PUT /products/{productId}
Выгрузка требований из Confluence
✅ Создание заказа
POST /products
Финальная выгрузка из Confluence добавлена к этому посту.
На что стоит обратить внимание в этой базе документации:
👉 1. Использование метода POST как на создание, так и на получение данных. Хотя POST в REST предназначен только для создания.
👉 2. PUT на редактирование товара с обоснованием, почему мы всегда хотим отправлять на сервер полный набор параметров, а не только изменённые - что можно делать в PATCH.
👉 3. Наличие нескольких каталогов API на сервере:
+ Поиск продуктов - public
+ Редактирование и создание продуктов - seller-api
Обратите внимание на разницу в полных URL.
👉 4. Оформление требований к обработке ошибок.
👉 5. Алгоритм кэширования в поиске товаров по каталогу.
👉 6. Примеры требований к логированию и мониторигу.
👉 7. Наличие макетов UI и схемы БД, которые были необходимы для работы.
Эти документы — одновременно:
◽️ реальные примеры с проектов,
◽️ решения задач с собеседований на Senior СА (особенно метод поиска с кэшированием).
Сохраняйте подборку в избранное и делитесь с коллегами ❤️🔥
#hardGetAnalyst
❤12
📚 Чек-лист: 42 API-термина, которые спрашивают СА на тех. собеседовании 📚
👉 Ключевые:
1. API (Application Programming Interface)
2. REST API (Representational State Transfer)
3. HTTP-методы запросов
4. Эндпоинты
5. Коды ответов
6. Ограничение частоты запросов (Rate Limiting)
7. Полезная нагрузка (Payload)
8. Заголовки (Headers)
9. Аутентификация
10. Авторизация
11. Пагинация
12. Кэширование
👉 Дополнительно:
1. OAuth
2. JWT Token
3. API Gateway
4. API Keys
5. Basic Authentication
6. Bearer Tokens
7. CORS
8. Webhooks
9. OpenAPI
10. API Versioning (Версионирование API)
11. Content Negotiation
12. Query Parameters
13. Path Parameters
14. API Documentation
15. API Monitoring
16. Throttling
17. Circuit Breaker
18. Idempotency (Идемпотентность)
19. API Proxy
20. Retry Logic (Логика ретраев / повторов)
21. Batch Processing (Пакетная обработка)
22. API Security
23. Health Checks
24. API Testing
25. Mock APIs
26. API Marketplace
27. API Schema
28. Semantic Versioning (Семантическое версионирование)
29. Hypermedia
30. API Deprecation (Устаревание API)
Всё самое важное и нужное на месте 😎
#hardGetAnalyst
👉 Ключевые:
1. API (Application Programming Interface)
2. REST API (Representational State Transfer)
3. HTTP-методы запросов
4. Эндпоинты
5. Коды ответов
6. Ограничение частоты запросов (Rate Limiting)
7. Полезная нагрузка (Payload)
8. Заголовки (Headers)
9. Аутентификация
10. Авторизация
11. Пагинация
12. Кэширование
👉 Дополнительно:
1. OAuth
2. JWT Token
3. API Gateway
4. API Keys
5. Basic Authentication
6. Bearer Tokens
7. CORS
8. Webhooks
9. OpenAPI
10. API Versioning (Версионирование API)
11. Content Negotiation
12. Query Parameters
13. Path Parameters
14. API Documentation
15. API Monitoring
16. Throttling
17. Circuit Breaker
18. Idempotency (Идемпотентность)
19. API Proxy
20. Retry Logic (Логика ретраев / повторов)
21. Batch Processing (Пакетная обработка)
22. API Security
23. Health Checks
24. API Testing
25. Mock APIs
26. API Marketplace
27. API Schema
28. Semantic Versioning (Семантическое версионирование)
29. Hypermedia
30. API Deprecation (Устаревание API)
Всё самое важное и нужное на месте 😎
#hardGetAnalyst
❤17
😁20❤9
Переделываем легаси-систему: история студентки «Дизайн REST API»
Полина — более 2-х лет работает системным аналитиком.
На текущем месте работы, когда она только устроилась, сначала задачи были больше «бизнесовые», но ближе к релизу проекта нужно было его всё больше сопровождать по технической части.
Нужно было переписывать множество endpoint'ов: за основу была взята легаси-система, которую мигрировали в новый интерфейс с новыми API endpoint'ами.
Для этого нужно было подтянуть REST API, плюс хотелось научиться работать с Postman и Swagger, так как всё, что до этого Полина изучала относительно этих инструментов, не давало полноценной картины.
В картинках далее со слов Полины➡️➡️➡️
#студентыGetAnalyst
Полина — более 2-х лет работает системным аналитиком.
На текущем месте работы, когда она только устроилась, сначала задачи были больше «бизнесовые», но ближе к релизу проекта нужно было его всё больше сопровождать по технической части.
Нужно было переписывать множество endpoint'ов: за основу была взята легаси-система, которую мигрировали в новый интерфейс с новыми API endpoint'ами.
Для этого нужно было подтянуть REST API, плюс хотелось научиться работать с Postman и Swagger, так как всё, что до этого Полина изучала относительно этих инструментов, не давало полноценной картины.
В картинках далее со слов Полины➡️➡️➡️
#студентыGetAnalyst
❤11🔥6👍1
В вакансиях на Системных Аналитиков постоянно встречаются формулировки:
+ Знание REST API / JSON
+ Опыт проектирования и документирования API
+ Понимание принципов работы мобильных приложений
+ Знание OpenAPI / Swagger
+ Навык тестирования API Backend (Postman / Insomnia)
Все эти навыки ожидают от Middle и Senior СА, которым предстоит работать с Backend, мобильными командами или в проектах с интеграциями.
❗️ Но это не про интеграции и чтение готовой API-документации, а про умение проектировать REST API методы с нуля, самостоятельно, и выстраивать стандарты API на любом проекте.
Мы приглашаем вас освоить REST API на практике в рамках одного большого проекта на программе:
🤍 Расширенный формат в феврале 2026:
+ 3 доп. онлайн-практики
+ 3 месяца доступа к обучению
+ записи уроков и Confluence-документация по доп. проекту
👉 Узнать подробности и записаться
🎁 Только до 12 февраля:
лучшая цена + обучение "Интеграции 4.0 - продвинутый уровень" в подарок.
В ходе работы учимся проектировать методы REST API с нуля, глядя на требования, архитектуру, БД и дизайн UI/UX системы.
Проект с подвохами и сложностями, на котором “набиваем шишки”, учимся писать с нуля и структурировать API-документацию, осваиваем ключевые инструменты СА 🛠
Это самая весомая и “программистская” часть вашего профессионального портфолио.
Есть вопросы?
Пишите @getanalyst или заполняйте анкету предзаписи. Мы свяжемся с вами, поможем оценить текущие навыки и ответим на вопросы! 🤝
Please open Telegram to view this post
VIEW IN TELEGRAM
❤3