Поймай волну вечера 🏄

REST API за вечер: от концепции до Postman
Уже сегодня в 19:00 по Мск!
РЕГИСТРАЦИЯ НА МАСТЕР-КЛАСС

Привет! Надеюсь, ты уже поставил напоминание? Мы поставили 😉

🕘 За 3 часа - ссылка на вебинарную комнату в почту
🕘 За 15 минут - напоминание во всех каналах и соцсетх GetAnalyst

Как и всегда - это не просто еще один вебинар или лекция. Это шанс поймать волну новых знаний на практике. Идем с серфом в океан и пробуем, пока не встанем на доску уверенно 🙌

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

Прокачаете резюме ключевыми словами: REST API, JSON, Postman. И всё это в уютной домашней обстановке, за чашечкой любимого напитка. Можно будет задать мне вопросы в прямом и обсудить вопросы 🚀

Делай шаг, чтобы стать более ценным специалистом для твоей компаниии. Магия начинается уже сейчас 🪄🔮

Уже через 3 часа! Мастер-класс Екатерины Ананьевой!

📹 REST API за вечер: от концепции до Postman
⏰ 19:00 - 21:00 Мск

Ссылку на трансляцию пришлем в канал за 15 минут до начала.

Спасибо за крутой эфир! Сегодня коллекцией Postman делились все участники мастер-класса!

Разобрали REST с нуля и сделали API-документацию с примерами разных запросов и ответов⚡️

Для Новосибирска повтор завтра в 15:00 по Мск ❤️

Регистрация на повтор, если уже регистрировались на основное мероприятие, не нужна.

Ссылка на 27 июля в 15:00 Мск -> здесь 😏

Гайд из 5 шагов по созданию API-документации в Postman

Зарегистрируйся и войди в Postman: https://www.postman.com/


1. Создай пространство workspace.

2. Создай первую коллекцию в нем.

3. Опиши первый метод и сохрани в этой коллекции. Можно описать больше.

Пример:

POST https://porschelab.com/api/v1/car

{
"producer": "Tesla",
"model": "Y",
"licensePlate": "GETANALYST-CA",
"vin": "JN1WNYD21U0000001",
"color": "pink",
"year": 2023,
"ownerIds": ["777abc91-e949-469a-9528-1d88dee33caa", "388abc91-e949-469a-9528-1d88dee33c65"]
}


4. Добавь примеры ответов через Add Examples.


Пример для 201-ОК:

{
"id": "65db1a9d-6919-4e93-a535-7250bd8d18d9",
"producer": "Tesla",
"model": "Y",
"licensePlate": "GETANALYST-CA",
"vin": "JN1WNYD21U0000001",
"color": "pink",
"year": 2023,
"owners": [
{
"id": "388abc91-e949-469a-9528-1d88dee33c65",
"lastName": "Ivanov",
"firstName": "Ivan",
"patronymic": null,
"birthday": "2000-12-19",
"phone": "123456789",
"phoneCode": "+1"
},
{
"id": "777abc91-e949-469a-9528-1d88dee33caa",
"lastName": "Ivanova",
"firstName": "Lena",
"patronymic": null,
"birthday": "2000-01-20",
"phone": "9998887766",
"phoneCode": "+1"
}
]
}


5. Переходи к просмотру - в режим документации. Это можно сделать на вкладке с обзором коллекции.

Получилось:
https://documenter.getpostman.com/view/20545501/2s946pYoPN

Хочешь инструкцию с картинками? Ставь ❤️ и она появится 🙃

Готовим подкаст на YouTube. Не могу не поделиться отрывком с процесса записи.

В нем важная информация для тех, кто сейчас меняет работу и ходит по собеседованиям 👀

Гайд из 5 шагов по созданию API-документации в Postman
с картинками 🖼👨‍🎨

Так понятнее!

Уверенность всегда на первом месте. Но ее вечно мало 😔
К сожалению, она никогда не возникает и не растет сама по себе. Её нужно развивать.

Можно пробовать устроиться на работу, пройдя курс по подготовке к собеседованиям, и "петь песни" работодателю: "Да, я это умею, и это тоже, я вообще крутой специалист" (про себя размышляя: если что, научусь в процессе). Но мы не в школе. И эта история с неумением всплывет на испытательном сроке, который может завершиться не так, как хочется.

Если ты:
🎯 уверен в себе и своих знаниях,
🎯 регулярно развиваешь профессиональные навыки через обучение,
🎯 умеешь последовательно, на примере задачи, рассказать о своих навыках работодателю,
то найти крутой проект, попросить повышение, или просто вести митинги с разработчиками становится так легко! Другие ощущения от общения! Представляешь?


Всегда важно подкреплять знания релевантным опытом. Дальше ловкость коммуникаций и никакого мошенничества: рассказ про реальную ПРАКТИКУ = УВЕРЕННОСТЬ. И я росла через нее.

По себе знаю, сколько бы ни было книг, лекций, ощущение уверенности не появится от знания теории. Потом сталкиваешься с реальной задачей, где нет универсальных решений, и нужно держать в голове множество мелких деталей, о которых ты даже не знаешь, и про которые автор в книге забыл написать. И страх - вот он, и ничего не выходит 😞

В системном анализе тяжело менять проекты - разные предметные области, процессы, услоия работы. Боишься, что не сможешь быстро адаптироваться, долго въезжаешь. Не понимаешь, как ставить задачи на разработчиков. Не хватает опыта переключения между проектами, структуры в знаниях, чтобы их можно было применить ко всему.

Чтобы разобраться, как все реально работает, все понять, нужны действия. И да, это не так просто как посмотреть видео. Но именно так с каждым разом прокачивается опыт и появляется уверенность.

Уверенность -это преимущество. Она как игра в карты с козырями. Это внутреннее ощущение позволяет легко принимать решения, быстро и эффективно решать задачи 🙌

Я хочу поделиться с вами приятным моментом ❤️

В пятницу у меня была финальная консультация в мини-группе - две девушки из наставничества по REST API апрельского потока. Я получила удовольствие от 2+ часов практики с ними!

Мы разбирали индивидуальные проекты. Я смотрела на внушительные файлы: API-документация, Swagger и Postman коллекции, созданные на ее основе. Я искренне восхощалась!

Все замечания с предыдущего разбора были исправлены, появились дополнительные вопросы к проработке, которые мы вместе решили.

Проделана большая работа по проекту, которую можно смело демонстрировать работодателям и рассказывать, как проходил этот проект! 💼

Не смотря на серьезность встречи, она прошла весело. Мы много смеялись, когда находили очевидные ошибки. Я просила их решать сложные задачи. Мы дополнительно рисовали экранные формы и смотрели, как сделать дизайн тела JSON для асинхронного метода. Опять ворчала на ошибки и думаю, что теперь они точно все по ним запомнили! И про xml в REST тоже!

В конце встречи был диалог:
- Какие результаты по итогам обучения? Удается ли использовать новые навыки в работе?
- Да. Моей целью на обучение было начать делать более технические постановки задач. И сейчас даже разработчики сказали, что я стала делать их лучше, детальнее, с большим пониманием темы. А еще я нашла ошибки в работе нашего API на проекте! ....

Это же круто?! Когда даже разработчики заметили эффект от освоения нового профессионального навыка!

Иискренне радуюсь за вас! Спасибо за мою пятницу ❤️

URI vs URL - что это и в чем отличия? 🧐

Возможно, вы уже встречали слова URI, URL и URN? Знаете, что это "ссылка в интернете", "ссылка метода в REST API" или "эндпоинт в REST API", но разница не очень понятна.

Давайте разберемся 👀


URL - это просто адреса в интернете, по которым можно получить доступ к разным информационным объектам, таким как веб-страницы или файлы. Мы часто видим их в адресной строке браузера или в ссылках, когда переходим по страницам сайтов.

Примеры URL (адресов):

URL веб-страницы: https://www.getanalyst.ru/about
Это URL, который вы вводите в браузере, чтобы перейти на страницу "О нас" на веб-сайте с доменом "www.getanalyst.ru".

URL изображения: https://www.example.com/images/picture.jpg
Это URL, который указывает на конкретное изображение с именем "picture.jpg" на веб-сайте "www.example.com".



URI - это еще более общий термин, который может представлять различные типы идентификаторов ресурсов в интернете.

Примеры URI (идентификаторов ресурсов):

Почтовый адрес электронной почты: user@example.com
Это URI, который идентифицирует электронный адрес "user@example.com".

ISBN (Международный стандартный книжный номер) книги: ISBN 978-3-16-148410-0
Это URI, который идентифицирует уникальный номер книги "ISBN 978-3-16-148410-0".

Социальный профиль в Twitter: https://twitter.com/example_user
Это URI, который идентифицирует профиль пользователя "example_user" на платформе Twitter.


🌟 URL - это просто один из видов URI, который указывает на местоположение конкретного ресурса.


URI является более общим термином и включает в себя URL как один из своих подтипов. В контексте REST API, клиенты используют URL в запросах для обращения к различным ресурсам и выполнения операций с помощью уникальных адресов в интернете.

🗝 /v1 - путь к ресурсу, версия API.
Версия API. Может быть указана в виде /1.0, /v1.0 и других возможных. Цифра версии обновляется кажый раз при выпуске изменений в API, которые меняют структуру ответа,
Настроятельно рекомендуется указывать, чтобы не сломать взаимодействующих с API клиентов при внесении в API обратно несовместимых изменений.

🗝 /auto/{autoId} - путь к ресурсу, конкретный эндпоинт.
Это часть URL, которая определяет конкретный ресурс (объект данных) или метод API, с которым клиент хочет взаимодействовать. Например, /users, /auto или /product/123.
Название объекта рекомендуется указывать в единственном числе auto, но можно и во множественном autos. Зависит от проекта и принятых внутри компании правил 😄



А еще в структуру URL встраивают иерархию:
GET htttps://www.PorscheLab.com/api/public/v1/auto/{autoId}/owner - владельцы авто.

Глаголы действия:
PATCH htttps://www.PorscheLab.com/api/public/v1/auto/{autoId}/archive - архивировать запись.


Все особенности формирования URL можно осознать и запомнить только после самостоятельной работы с проектированием REST API и постановкой задач на Backend. А пока пересылайте себе в избранное и коллегам сообщение выше, чтобы не потерять ❤️

Хочу поделиться с вами историей о девушке-юристе. Она всю жизнь занималась юриспруденцией, и никогда не думала, что когда-то окажется перед камерой.

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

‼️ Казалось бы, ведь она каждый день общалась с клиентами и давала им советы, но для ведения блога оказались нужны совсем другие навыки.

Первый съемочный день наступил, девушку загримировали, посадили перед камерой, свет горел ярко — и началось! Но ее голос дрожал, а лицо покрылось красными пятнами из-за стресса. Съемку пришлось приостановить, и вместо нее ролики записывал другой юрист.

Прошло несколько дней, и руководство решило дать ей еще один шанс. Но в этот раз все пошло еще хуже — она даже потеряла сознание прямо в кадре! Не представляете, что она пережила: запинки, покрасневшее лицо, пот и страх перед камерой. Каждый раз съемка была сложной, ей приходилось множество раз гримироваться и делать дубли.

Но, знаете, чудо произошло! С каждой новой попыткой она становилась все увереннее. Она не сдавалась, а продолжала пробовать, пока наконец не начала уверенно блистать в кадре! Один оператор, который работал с ней, заметил, как она стала уверенней и естественней в кадре. Записей стало меньше, запинок не было — она просто привыкла! 🏄

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

В работе аналитиков мне это напоминает прохождение собеседований, знакомство с новыми проектами, выход на новую работу, освоение новых навыков. И именно практика и неотступность перед целями позволяют нам дойти до результатов 🌟

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

Верьте в себя и смело идите к своим целям! 🚀

📹 Нашла это трогательное видео про поддержку и помощь в субботу. И оно в очередной раз напомнило: "делай добро - оно вернется, обязательно" ❤️

Бывают связанные с работой ситуации, когда нужна помощь и ты тратишь много времени, чтобы быстро что-то изучить или найти информацию.
Например, выход из РФ зарубежных компаний и массовое перераспределение кадров. Кому-то сейчас запрещают работать за пределами страны, а хочется путешествовать.
Такие ситуации мотивируют резко расти, чтобы сменить работу. Бывает, что вынужденно, не по собственному желанию, а в условиях "бей или беги", из страха.

Давайте помнить, что важно помогать друг-другу ❤️ GetAnalyst изначально про обмен опытом. Это наше сообщество системных аналитиков, в котором мы поддерживаем друг-друга в карьерном росте.

У нас есть начинающие свой путь в IT, опытные системные аналитики, бизнес-аналитики и не только. Бывает сложно в пути, когда нужна помощь или поддержка, совет. Не стесняйтесь задавать свои вопросы в комментариях под постами или в нашем чате 🌟

Мы по жизни стремимся помогать друг-другу, не только в работе. Это естественное желание. Да и добро возвращается добром.

Помогайте коллегам в аналитике, кто стремится к росту. Даже небольшими советами. Это ценно. Не думайте, что создаете конкурентов. Вы создаете помощников! Вы оцените это, когда дорастете до ведущих или руководящих позиций 🙌

Делай добро - оно вернется, обязательно 🪄

🌟 Запускаем подкаст 🌟
GetAnalyst: Опыт экспертов

Одна из самых востребованных тем - прохождение собеседований. Записали подкаст по разбору задачи на асинхронные запросы в REST API.

Прежде чем смотреть видео до конца, попробуйте решить задачу сами, а потом сверить ответ 😉

Собеседование на системного аналитика: разбор задачи на асинхронные запросы
Подкаст с Никитой Румянцевым
Ведущий fullstack-аналитик в Fertami LTD

Если вам понравилось видео - поддержите ❤️ в YouTube, и предлагайте в комментариях темы, которые хотели бы обсудить 🙂

«Если разработчик ничего не ответил на требования, проверьте его пульс» 🙃

Шутки шутками, но нередко бывает, что человек по ту сторону экрана мало что понял и долго пытается вникнуть в текст.


Почему так происходит?

🔹Текст, выглядит как огромная простыня, где конца и края не видно. Нет структуры в требованиях, отсутствуют абзацы и отступы.

🔹 Длинные, как товарный локомотив, предложения, которые только начал читать и уже устал.

🔹 Много лишних вводных слов, в которых теряется суть и необходимо напрячься, чтобы её «выловить».

🔹 Мысль перескакивает с одной на другую. Читатель путается, теряется смысл повествования.


👩: Чтобы излагать требования чётко не нужно быть гуру копирайтинга или внуком филолога.

Краткость и ясность требований — это ключевые факторы, которые влияют на качество разработки. Это как волшебство вне Хогвартса 🪄
Если требования имеют общую или неоднозначную формулировку, это может привести к ошибкам в конечном решении и задержкам в сроках 😖


Что делать, чтобы этого избежать?

1️⃣ Делите на логические блоки;
Уже визуально такой текст выглядит проще. Благодаря абзацам читателю легче ориентироваться в повествовании.

2️⃣ Сокращайте предложения;
Если видите, что предложение уже растягивается на четыре строчки, то смело его делите на два.

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

3️⃣ Забудьте про слова «вероятно», «однако», «действительно», «наконец» и другие;
Эти вводные слова не дают полезной информации и утяжеляют текст.

4️⃣ Один абзац — одна мысль.
Каждый абзац должен содержать только одну главную идею. Это помогает читателю лучше понимать текст и улучшает его восприятие.


👩: Рекомендую аналитикам уделить особое внимание этим правилам. Когда вы овладеете навыком сокращения и упрощения своей документации без потери смысла, разработчики и тестировщики будут вам искренне благодарны.


Если хотите больше углубиться в тему, можете изучить книгу «Пиши, сокращай» от М.Ильяхова и Л. Сарычевой. На конкретных примерах авторы показывают, что такое плохой текст и как его улучшить.

Я тут решила научиться играть в теннис.🎾 Пробовала играть пару месяцев сама, по принципу "все же легко, я же видела как другие играют, я просто их копирую и должно получаться".

Казалось, что все идет хорошо. Играю, лучше с каждым разом, но не сильно. И что-то ощущалось не так, часто промахивалась по мячу.

Знакомо ощущение, когда что-то делаешь, и кажется, что получается, а на самом деле не очень? 🤔

В итоге взяла урок у тренера, и... Я всё делала вообще не так! 😅 Но уже после первой тренировки базовые принципы стали ясны! Оказалось, что в теннисе свои нюансы и тонкости. Принцип движения руки для удара по мячу, секретные слова "bounce-hit" для оценки времени на удар, о которых я даже не знала где читать! Два месяца тупила, а в итоге базу освоила и закрепила всего за три занятия, а дальше - больше!

Эта ситуация в очередной раз напомнила мне, что наставник важен ❤️

С работой и карьерой так же. Бывает, что хочется расти, но трудно найти правильный путь. Тратишь много времени, чтобы что-то изучить самостоятельно. А на самом деле надо было не тупить и сразу взять тренера, чтобы ускорить этот процесс 🚀 Но ты упорно продолжаешь ходить страшными, долгими, а порой даже опасными путями (могла повердить кисть). Надо поставить картинку на заставку: время ценно.

У меня есть хорошая новость: на программе REST API осталось всего 3 места. И пока идет предобучение еще есть возможность присоединиться, чтобы уже в октябре с новым навыком в проектировании систем брать новые задачи и проекты.
Обучение в карьере - это короткий путь к успеху 🌟

Давайте выбирать короткие и правильные пути, сохранять наше время для приятных занятий, и вместе идти вперед. Один – хорошо, но когда у тебя есть гид - то путешествие в новый мир проходит иначе 🙌