✨ ПРО МЕТОДЫ REST API ✨

Продолжаем с важной для системных аналитиков темой интеграционного взаимодействия систем. И сегодня поговорим про методы REST API #hardGetAnalyst

Как вы уже знаете, REST API - это архитектурный стиль проектирования взаимодействия нескольких систем. Этот стиль использует протокол HTTP для общения между системой-клиентом и системой-сервером. Поэтому интеграционное взаимодействие иногда ещё называют клиенто-серверным.

REST API позволяет клиентам выполнять операции с данными внутри ПО по CRUD-модели.
CRUD-модель представляет собой четыре основных функции, которые напрямую связаны с REST API:

1️⃣ CREATE (Создать) = POST в REST API
Это процесс для создания новой записи в системе. Например, при регистрации пользователя в каком-либо приложении.

2️⃣ READ (Прочитать) = GET в REST API
Это операция для получения или чтения данных из системы. Например, при запросе информации о пользователе, который зарегестрировался в приложении.

3️⃣ UPDATE (Обновить) = PUT или PATCH в REST API
Это операция для обновления существующих данных в системе. Например, при редактировании данных зарегестрированного пользователя в приложении: его адреса, номера телефона и так далее.

4️⃣ DELETE (Удалить) = DELETE в REST API
Это операция для удаления данных из системы. Тут отлично впишется пример, когда пользователь решил удалить свой профиль в каком-либо приложении.

Важно помнить: конкретное использование этих методов REST API может отличаться в зависимости от специфики API и/или проектируемой системы. Знание же этих методов и их различий между собой поможет определить, как необходимо споектировать интеграционное взаимодействие, чтобы получить необходимый результат.

Когда HR говорит загадками 😮
#GAhahaha

✨ РАЗНИЦА МЕЖДУ PUT И PATCH ✨

Начнём с того, что PUT и PATCH предназначены не только для изменения данных, но и для их создания.
Разберём на примере работы с комментарием к товару на маркетплейсе.

Предположим, комментарий (comment) состоит из:
- заголовка с именем пользователя (name),
- тела комментария (text).

Для создания комментария можно использовать аж три метода: очевидный POST и менее очевидные PUT и PATCH.

Например, пользователю Ивану понравился товар, который ему доставили, и он решил этим срочно поделиться. В этом случае есть три вариации создания комментария:

1️⃣ POST /comment/1
{
name: 'Иван',
text: 'Я очень рекомендую этот товар!'
}

2️⃣ PUT /comment/1
{
name: 'Иван',
text: 'Я очень рекомендую этот товар!'
}

3️⃣ PATCH /comment/1
{
name: 'Иван',
text: 'Я очень рекомендую этот товар!'
}

Предположим, используя товар, Иван понял, что результат его не удовлетворил. Теперь Иван хочет отредактировать свой положительный отзыв на негативный. Метод POST создаст только новый комментарий, но не изменит ранее созданную запись. Остаётся два варинта: PUT и PATCH.

Продолжим совсем скоро...

#hardGetAnalyst

Итак, наш рандомный Иван разочаровался в товаре и решил отредактировать свой ранее оставленный отзыв на маркетплейсе.
Мы хотим изменить только текст комментария, а значит отправлять в методе будем только text.


1️⃣ При использовании метода PUT, весь комментарий перепишется заново.
Учитывая, что в методе мы передали только текст комментария, но не передали имя пользователя, прошлая запись обновится до состояния, где имя будет отсутствовать, а текст изменится.

PUT /comment/1
{
text: 'Я вообще не рекомендую этот товар!'
}

Запись изменена, но теперь сам комментарий неполноценный - у него напрочь отсутствует информация об имени пользователя.


2️⃣ Что же произойдёт в PATCH-методе?🤔
В случае "пластыря" ("patch" с англ. "пластырь") будет изменена только та часть, которая была отправлена в запросе.

PATCH /comment/1
{
text: 'Я вообще не рекомендую этот товар!'
}

При передаче в PATCH-методе только текста комментария, имя пользователя останется неизменным, а текст комментария обновится. То, что нужно, когда нужно переписать только часть данных, а не весь объект комментария.


КОРОЧЕ ГОВОРЯ:

⚡️PATCH используется для того, чтобы изменить часть данных в записи. Говоря на языке метафор, этим методом можно прилепить "пластырь" в неактуальной части всего полотна информации.

⚡️PUT же в свою очередь обновляет полотно полностью, то есть создает новый ресурс данных. Что актуально для изменения всего объекта целиком.


Ну что ж, вам может показаться, что тема REST API довольно сложная и тернистая 😫
Отчасти так и есть. Но если вы хотите оставаться конкурентоспособным на рынке труда в сфере IT, REST API понять придётся. А для понимания необходимо изучать теорию и отрабатывать её на практике, формируя навык.

🤩 КСТАТИ ОБ ОБУЧЕНИИ 🤩

Уже завтра у нас пройдёт открытый вебинар, где Екатерина Ананьева расскажет про REST API простым языком. По результатам встречи вы не только с нуля разберётесь в теме, но даже научитесь описывать документацию для интеграционного взаимодействия по API!
А это дорогой hard skill системного аналитика 💸💸💸

📚 Про REST API за 2 часа: с нуля до Swagger-документации
📅 24 ЯНВАРЯ, 19:00 МСК
🔗 ЗАРЕГИСТРИРОВАТЬСЯ

План работы на вебинаре:
1. Самая важная теория по REST API и квиз для её закрепления.
2. Проектирование методов REST API с нуля.
3. Создание Swagger-документации для спроектированных методов.
4. Шаблон постановки задачи на разработку REST API-метода.

От вас:
1. Зарегистрироваться в Swagger. Инструкцию продублируем в комментариях к этому посту.
2. Перечитать базовую теорию по REST API, чтобы быть в теме на встрече.
3. В процессе онлайн-практикума работать с компьютера и быть активными в чате, чтобы лучше закрепить знания по REST API.

Увидимся на вебинаре! 😘

😂👍👍❤️👌😅😊😊😍😘

❗️До начала 15 минут❗️

📹 Про REST API за 2 часа: с нуля до Swagger-документации

Переходите по ссылке: https://pruffme.com/webinar/?id=cfbaba2b3142b38994e60652dbe9760d и начинаем!

🤩 КАК ИЗМЕРЯТЬ СВОЙ УСПЕХ? 🤩

Помните, как в детстве мартышка из мультика измеряла удава?
По итогу удав был бы равен 31 мартышке или 9 слонятам.

К сожалению (или к счастью?), успех мартышками не измерить. Его вообще трудно измерить в какой-то конкретной единице 👀

Многие привыкли измерять достижения двумя сферами: доход и должность на работе. Если ты директор, то успех в кармане. А если рядовой служащий, то твои результаты в работе подвергают сомнениям. Но разве это объективно? 😢

Жизнь не состоит только из работы и зарплаты. Успех — это совокупность различных сфер.
Среди них:
⏩ваше окружение,
⏩личностные качества, которые вы уже имеете или стремитесь получить,
⏩ментальное и физическое здоровье, которые требуют ресурсов для поддержания,
а ещё ведь есть увлечения, которые тоже говорят о вас многое!
Короче говоря, одна лишь работа не сделает вас абсолютно счастливым и успешным.

Чтобы отслеживать свои результаты и корректировать вектор развития, специалисты рекомендуют периодически использовать технику «Колесо баланса» ⬇️

#softGetAnalyst

🎡 ТЕХНИКА «КОЛЕСО БАЛАНСА» 🎡:

1. Возьмите чистый лист бумаги
или любой другой инструмент, в котором вам будет удобно рисовать (планшет, Figma и тд).

2. Нарисуйте круг из 8 секторов:
- Здоровье,
- Работа,
- Финансы,
- Отношения,
- Уровень комфорта,
- Личностное развитие,
- Отдых / Досуг,
- Окружение.

🥷: Вложите в каждый из секторов тот смысл, который актуален лично для вас.
Например:
- к здоровью можно отнести физическое и/или ментальное или разделить этот сектор на два;
- отношения, которые для вас важны, могут быть как семейными или романтическими, так и отношения с самим собой;
- к уровню комфорта можно отнести удовлетворение собой или своим имуществом
и так далее.


3. В каждом секторе нарисуйте шкалу с десятью делениями,
чтобы разделить сектор на 10 горизонтальных кусочков. Один кусочек - это один уровень удовлетворённости.


4. Оцените каждый сектор по 10-балльной шкале, закрасив каждую единицу шкалы.
При оценке постарайтесь понять уровень удовлетворения этой сферой своей жизни в текущий момент. И отметить, какие факторы влияют положительно, а какие – отрицательно.

🦸‍♂️: Например, если вы понимаете, что просмотр сериалов в качестве отдыха оставляет чувство неудовлетворённости, то, скорее всего, этот не тот формат досуга, который вам подходит.


🧐 ЧТО В ИТОГЕ? 🧐

Благодаря такой простой визуализации вы выявите «отстающие» сферы и поймёте, где ваши зоны роста. Останется только выбрать тот сектор, который станет у вас акцентным для улучшения в ближайшее время. И приступить к созданию плана улучшения своей жизни 💜

Желаем вам классных трансформаций, ребят.
И отличного завершения рабочей недели.