GetAnalyst - Навыки • Системный анализ • Бизнес-анализ
19.6K subscribers
2.1K photos
75 videos
207 files
1.19K links
Разбор задач на проектирование систем 🚀 Канал для системных аналитиков, бизнес-аналитиков, тестировщиков и менеджеров проектов

Админ @getanalyst
Сайт https://getanalyst.ru
Чат t.me/getanalystchat
Начинающим в IT @getanalyststart

РКН №5013005196
Download Telegram
🧑‍💻 Создаем API-методы для проекта #RecipeGA | Практика 🧑‍💻

В кулинарном проекте RecipeGA, REST API нужен для веб- и мобильных приложений.

Поэтому, чтобы начать работу с проектированием:

1. Смотрим дизайн в Figma → отсюда берём
+ экраны и определям методы под них,
+ поля, которые нужно поддержать для выбранных методов.
🔗 Ссылка на Figma проекта

2. Заглядываем "под капот" — в Базу Данных
🔗 БД проекта RecipeGA


👉 В дизайне Figma вы найдёте 3 экрана:
+ список рецептов,
+ просмотр рецепта,
+ создание рецепта.

Коллеги, завтра будем использовать эти материалы на открытом вебинаре, так что рекомендую с ними познакомиться заранее 🤝


👉 И у меня к вам вопрос на оценку опыта в REST API:

Сколько REST API методов
рекомендуется
сделать для экрана просмотра рецепта?

Методы под кнопки "Отправить рецепт", поиск рецептов и вход в аккаунт в "шапке" страницы не учитываем, "Вход в аккаунт" внизу страницы - аналогично.

К посту для удобства прикрепила 4 скрина экрана с рецептом, который анализируем (это один экран).

Варианты ответов:

1 метод - 👍
2 метода - ❤️
3 метода - 🔥
4 метода - 🦄


Голосуем реакцией и предлагаем варианты в комментариях 🙂📝

Ответ подробно разберу и обосную в конце этой недели.

#RestApiGA
Please open Telegram to view this post
VIEW IN TELEGRAM
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥41🦄1612👍12
🔔 Сегодня в 19:00 мск | Открытый вебинар по REST API с практикой в Postman + фишками AI 🔔

Встречаемся сегодня, чтобы:
+ познакомиться с теорией REST API на практике, через Postman
+ получить новый опыт в проектировании REST API методов с нуля,
+ узнать основные ошибки, которые допускают IT-специалисты,
+ получить набор инструментов для работы!


🔥 5 ошибок в дизайне REST API
🗓 24 апреля (чт), 19:00 - 22:00 Мск
🔗 Подробности и регистрация

👉 Запись будет доступна только для зарегистрированных участников.


Инструменты к освоению:
Postman
Консоль браузера
Figma с дизайном UI/UX
dbdiagram со схемой БД (ER-диаграмма)
ChatGPT для ускорения работы


-----------
Подготовка:
Перед эфиром установите Postman, попробуйте сделать Workspace и первую коллекцию по инструкции. Всё остальное покажем онлайн.
Инструкция по Postman с нуля
-----------


Реальная работа и серьёзная аналитика.
Будем погружаться в сложную теорию через разбор конкретных примеров.

До встречи в прямом эфире! 😉
Please open Telegram to view this post
VIEW IN TELEGRAM
7🔥5👍4👌1
❗️Встречаемся онлайн через 3 часа❗️

📹 5 ошибок в дизайне REST API: примеры реальных задач с проектов и собеседований
19:00 - 21:30 Мск

[
ЗАРЕГИСТРИРОВАТЬСЯ ]


-----------------------------------
Подготовка к практике:

Перед эфиром установите
Postman и зарегистрируйте аккаунт в нём!

Всё остальное покажем онлайн.

Инструкция по Postman с нуля

-----------------------------------

👉 Запись эфира будет доступна только для зарегистрировавшихся участников
👍153🎉3
Я хочу начать этот пост с огромной благодарности каждому, кто был вчера со мной в прямом эфире на практическом вебинаре по ошибкам в REST API ❤️

Спасибо вам за это время и вовлеченность!
Спасибо, что инвестируете время в своё развитие вместе со мной и GetAnalyst.
Спасибо за тёплую обратную связь, которую я получила 🫶


Мои занятия — это не про «пройтись по верхам».
Я всегда иду в глубину.
И это требует времени.

Я про то, чтобы вы действительно разобрались в теме и получили максимум пользы, проведя своё время со мной. Чтобы вы не просто узнали что-то новое, а получили реальный опыт и глубокое понимание.


Вот, что мы вчера успели:
🔹 Разобрали особенности REST API на примере реального API
🔹 Исследовали его работу через Postman
🔹 На практике определили более 5 распространенных ошибок проектирования, которые делают даже опытные специалисты
🔹 Зафиксировали что нужно в качественной постановке задачи на разработчика - передала шаблоны
🔹 Изучили как работать с промптами в современных AI
🔹 Поделилась промптом и AI-ботом GetAnalyst для проектирования REST API

Это много и вы молодцы!

Вы задавали вопросы, делали задания, получали обратную связь.
Всё на одном дыхании!
Ваааау! 😍


Для тех, кому не удалось подключиться, остаться до конца или хочется еще раз повторить всю практику, чтобы закрепить результат:

🔥 5 ошибок в дизайне REST API
🗓 Доступ к записи с 26 до 28 апреля (сб-пн)
👉 Получить доступ

Если уже регистрировались на основной эфир, то ПОВТОРНО РЕГИСТРИРОВАТЬСЯ НЕ НАДО!
Письмо с доступом придёт в субботу утром.


👉 Эта встреча была вводным занятием к практической программе Дизайн REST API, которая стартует уже 6 мая.

Следующий онлайн-поток будет только в октябре.
Так что, если чувствуете, что сейчас — ваше время, чтобы двигаться вперёд в карьере, буду рада видеть вас на следующем онлайн-занятии после майских выходных 🙌


Спасибо вам. За доверие. За рост. За энергию.
За то, что выбираете расти в карьере с GetAnalyst ❤️‍🔥


Искренне ваша,
Екатерина Ананьева
Please open Telegram to view this post
VIEW IN TELEGRAM
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥40👍1710❤‍🔥10🥰7
👀 Сколько API-методов ты видишь на картинке? 😅

В среду дала задание на определение количества API-методов, которые нужны на экран просмотра информации о рецепте для нашего проекта 🙂 Дизайн в Figma тут.

Важно:
Методы авторизации и из "шапки" приложения не учитывать.


Правильный ответ: 2
или 3
(3 тоже верно, если мы подумали об одном и том же 😅)


1. Получение информации о рецепте по его id
GET .../v1/recipes/{recipeId}


2. Получить список комментариев рецепта
GET .../v1/recipes/{recipeId}/comments



3. Метод, которого на этом экране нет в состоянии, когда пользователь не авторизован, но он появляется, когда пользователь войдёт в систему.
И это... Возможность оставить комментарий:
POST .../v1/recipes/{recipeId}/comments



Были ли у вас какие-то ещё предложения или идеи? Делитесь в комментариях 😊


#RecipeGA #RestApiGA
Please open Telegram to view this post
VIEW IN TELEGRAM
Please open Telegram to view this post
VIEW IN TELEGRAM
20👍15❤‍🔥63🤔3
🧲 Что общего у сильных аналитиков? 🧲

Я работаю с огромным количеством специалистов. Разные бэкграунды, разный опыт.

Но есть нечто общее у тех, кто ставит цели и быстро выходит на качественно новый уровень в своей карьере. Они выделяются среди остальных.

И это не про хард-скиллы. Это про особенности личности.


Черты, которые я вижу снова и снова у всех специалистов, кто у нас примерно в середине или к завершению обучения получают офферы:

💎 Они вникают в детали.
Не потому что надо. А потому что им реально интересно, как всё устроено.
Они могут завалить меня вопросами, попросить разобрать ещё пару примеров, докинуть теории, чтобы прям понять до конца.
Они не проходят мимо непонятного — им важно разобраться.
Это всегда видно.
Я это очень ценю и всегда помогаю!

💎 Желание понять.
Не просто «услышал — записал».
А: «погоди, а почему именно так? а если вот так?».
Они мыслят, задают вопросы, цепляются за нюансы.

💎 Терпение.
Когда не получается с первого раза — не психуют.
Не сдаются. Просто садятся и разбираются.
Переделываю работу по моим "100 комментариям" в Confluence.
Иногда молча, иногда с вопросами.
Но всегда с уважением к процессу.


Это как настройка на уровне личности.
Внутреннее спокойное упрямство.
Сильная мотивация. Настрой на рост.

Каждый раз, когда я это вижу — появляется ощущение, что человек уже наполовину на финише.

Потому что с таким подходом всегда получается.
Не обязательно быстро. Не всегда гладко.
Но обязательно 🚀🚀🚀


Сама такая, видимо сила притяжения работает 🧲
Please open Telegram to view this post
VIEW IN TELEGRAM
💯62❤‍🔥31🔥2012👍8🥱2😢1🍾1
📹🔔 REST API на практике: доступ к обучению завершается сегодня 🔔📹

В этом открытом уроке:
▫️ Практика Postman
▫️ 5+ ошибок проектирования REST API, которые допускают даже опытные специалисты
▫️ Как использовать AI-помощника в работе с REST API

Всё чётко, по делу и через реальную практику.
Не буду описывать сама, а лучше поделюсь обратной связью за выходные.


Cегодня последний день, когда можно посмотреть занятие:
👉 Получить доступ

Это действительно важное обучение по REST API, которому стоит уделить время.


P.S. Кто уже прошел занятие - помогите коллегам найти мотивацию комментариями и реакциями ❤️‍🔥
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥205❤‍🔥4👍3
GetAnalyst_Ответы_на_задания_по_REST_API_для_подготовки_к_собеседованию.pdf
551.9 KB
👩‍💻 Подборка вопросов по REST API для подготовки к собеседованию на СА 👩‍💻


Практические задания - это всегда отличный способ:

🔹 Размяться перед реальным интервью
— вспомнить теорию и практику по вопросам, которые давно не использовали в работе;
— потренироваться отвечать вслух, уверенно и без суеты.

🔹 Потренироваться в формулировках ответов
— записать свои ответы в аудио (например, на Zoom конференции с самим собой), прослушать и убедиться, что тебе самому понятно то, что ты говоришь.
— научиться сразу подкреплять ответы примерами из своей практики.

🔹 и заодно — проверить, насколько уверенно вы ориентируетесь в REST API уже сейчас.


Вопросы не просто «что такое REST», а с упором на практику и нюансы, которые действительно спрашивают у мидлов и сеньоров.


Прикрепила к посту два файла:

1. Только вопросы
2. Эти же вопросы, но с краткими ответами



Пробуйте отвечать письменно или вслух — так лучше запоминаются идеи и легче ловить свои слабые места 🙌

Сохраняйте и пользуйтесь.
Сейчас или в будущем 🤝

#RestApiGA
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥49👍9👏8❤‍🔥53👀3
GetAnalyst_REST_API_метод_Заполненный_шаблон_задачи.pdf
1.2 MB
🔥 REST API: заполненный шаблон постановки задачи 🔥

Теория — прекрасно, но лично мне часто не хватает образцов, на которые можно смотреть и делать по аналогии.

Поэтому я подготовила для вас пример постановки задачи на REST API метод.


1️⃣ Шаблон постановки задачи с ним:
✔️ на старте видишь все обязательные блоки по задаче, которые надо заполнить для разработчиков
✔️ проще, чем каждый раз начинать задачу с чистого листа
✔️ вся команда всегда чётко знает, где и в каком месте располагается каждая часть требования к REST API методу


2️⃣ Пример использования шаблона поможет:
✔️ быстро увидеть, как заполняются все разделы на реальном кейсе
✔️ понять JSON-структуру, как строится метод и маппинг данных
✔️ избежать типичных ошибок с "не учел" и "не продумал"


Шаблон постановки задачи на REST API метод описан в этой статье.

📥 А к посту прикреплен документ из Confluence:
пример использования шаблона для метода GET /recipes/{recipeId} - получения рецепта по id для экрана просмотра рецепта на проекте #RecipeGA

Сохраняем и пользуемся 🤍


#RestApiGA
🔥5013👍4🤩31❤‍🔥1🤔1
🪲 Документирование ошибок в REST API: практическое руководство для системного аналитика 🪲

🔗 Ссылка на полную статью

Проектирование API – это не только про описание успешных запросов и ответов, но и продуманная обработка ошибок.

Зачастую ошибки начинают всерьез обсуждать лишь после того, как тестировщик пишет в чат «ничего не работает» или «а это нормальное поведение?».

Однако прорабатывать возможные ошибки и формат ответов на них нужно заранее, на этапе системного анализа и разработки контрактов REST API методов. Да и в целом, не только REST, а любого API.


Что важно знать про ошибки в REST API:

HTTP-код ошибки
Возвращается «снаружи» тела ответа.

Список HTTP-кодов стандартизирован (RFC 9110):
▫️ 2XX – ошибки нет, запрос принят и обработан успешно,
▫️ 4XX – ошибки на стороне клиента (проблемы с форматом или структурой запроса),
▫️ 5XX – на стороне сервера (проблемы во внутренней логике работы сервера - обращения в БД, проверки данных и другие)

👉 Полный перечень на русском


Response Body: JSON-сообщение в дополнение к HTTP-коду
Стандартная структура сообщения об ошибке делает API понятным и удобным.

Хорошо продуманный ответ должен ясно объяснять проблему разработчику клиентского приложения, который использует API, и, косвенно, конечному пользователю.

Пример:
{
"error": "2020_VALIDATION_ERROR",
"message": "Данные не прошли валидацию.",
"details": {
"email": "Некорректный формат email.",
"age": "Возраст должен быть положительным числом."
},
"traceId": "c82f3d9b-12f0-487b-9eae-1d234e9f9123"
}




Стандарт «Problem Details» (RFC 7807/9457) по проектированию ошибок в API
Предлагает единый формат JSON для сообщений об ошибках (MIME-тип application/problem+json).
Обновлен в 2023 году.

👉 Стоит сохранить ссылку на него в закладки.


Примеры API-документации с примерами описания ошибок
👉 ЦИАН API
👉 Wieldberries API



Всю информацию с примерами собрала для вас в полном практическом руководстве:

🔗 Ссылка

Доступна в блоге GetAnalyst 🤝

#RestApiGA
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥19👍104❤‍🔥1
Если бы майские выходные были фичей, это был бы самый долгожданный релиз года 🥳

Release notes:
«Добавлена долгожданная функция безопасного отключения от рабочих чатов, алерты мониторинга пересылаются в никуда, а уровень кофеина падает до безопасного для сна».

Всем классных выходных!
Ваша команда GetAnalyst ☀️
57❤‍🔥17😁8🔥7
🧑‍💻 [3-5 мая] Расширенный доступ к занятию: REST API + Postman + AI 🧑‍💻

Майские выходные — это скрытые возможности для карьерного роста. Поэтому пока все планируют шашлыки, вы можете заметно прокачать навык, который реально заметят в резюме.

Мы продлили доступ к уроку по ошибкам в REST API из-за множества восторженных отзывов по результатам практики!


🗓 Доступ к записи 3, 4 и 5 мая
🔗 Получить доступ

Что внутри:

👉 Живая практика в Postman
👉 Разбор 5+ самых “подлых” ошибок в API-дизайне
👉 Знакомство с AI-промптами для автоматизации работы


Это вводное занятие к практической программе Дизайн REST API, которая стартует 6 мая.

Не упускайте возможность пройти весь урок по проектированию REST API, повторить материал и закрепить навык!
Please open Telegram to view this post
VIEW IN TELEGRAM
18🔥4❤‍🔥2