В задаче для #BookingGA есть особенности, которые делают интеграцию сложной.
Они связаны с подбором методов под Use Cases для:
Еженедельной рассылки новостей о новых объектах недвижимости и выгодных предложениях
В этом посте я покажу, как простая задача на интеграцию может скрывать под собой много скрытых работ. И все "подводные камни" найдём благодаря анализу Списка доступных API-методов
Часть 1. Подписка пользователей
✅ UC1. Создать лист контактов при создании нового города в справочнике Администратором
createList
Удаление и редактирование поддерживать пока не будем, хотя тоже можно.
✅ UC2. Добавление пользователя в лист контактов по городу при настройке подписки
subscribe
+ в процессе регистрации
+ в настройках уведомлений
Часть 2. Рассылка email
✅ UC3. Создать шаблон письма с новыми актуальными предложениями по городу
Редактировать существующий шаблон сообщения в Unisender:
updateEmailTemplate
✅ UC4. Сделать рассылку обновленного шаблона для выбранного города
+ вручную
+ автоматически, по крону (расписанию)
createEmailMessage - создать сообщение, используя шаблон, но не отправлять
createCampaign - запланировать или немедленно запустить рассылку на основе созданного сообщения
Часть 3. Отписка пользователей
✅ UC5. Отписать пользователя от рассылки на выбранный город
unsubscribe
Дополнительно:
✅ Подготовка стандартного сценария авторизации всех запросов к Unisender и типовой обработки ошибок
✅ Импорт всех контактов системы в общий лист контактов Unisender из БД #BookingGA
Скрипты для разового прогона, можно вручную. Нужно для других рассылок по системе. Не обязательно в рамках этой истории
✅ Первичная настройка шаблонов и сопоставление их с городами в БД
---
UC = Use Case
---
👉 Итого:
+ 5 интеграционных Use Cases
+ 7 API-методов внешней системы
+ 3 тех.задачи
👉 Моменты, на которые стоит обратить внимание: UС4 с двумя API-методами, и сценарий авторизации, который аналитики забывают описывать.
#ИнтеграцииGA
Please open Telegram to view this post
VIEW IN TELEGRAM
👍11❤4🔥3👌1
🧑🔬🟠 Сначала исследовательское тестирование API в Postman, а потом сценарий интеграции 🟠🧑🔬
Прежде чем писать детализированный интеграционный Use Case, настоятельно рекомендую протестировать API, чтобы понять, как он работает, и убедиться, что документация соответствует реальности.
👉 Проверять важно только те методы, которые необходимы для работы системы.
Вообще всё по API-документации проверять не нужно.
Исследовательское тестирование API позволяет:
✅ Понять поведение API, особенно момент с работой авторизации запросов.
✅ Выявить расхождения между документацией и фактической реализацией API.
✅ Определить, какие данные реально передаются и принимаются.
✅ Понять, как API обрабатывает ошибки и исключения; найти то, что не задокументировано, чтобы продумать обработки на свои "узкие места" в сценарии.
🟠 Postman — главный инструмент аналитика для работы с API и проведения его исследовательского тестирования. А также один из ключевых навыков в резюме СА.
Если вы хотите работать с Backend-командами и понимать API, то без него никуда.
Он помогает проверять, как работают API-методы, не написав ни одной строчки кода.
С помощью Postman можно проверять:
+ REST API
+ GraphQL
+ gRPC
+ WebSocket
и другие виды API.
Чтобы познакомиться с инструментом в деле, предлагаю поработать с этими практическими руководствами:
🔗 Практическое руководство по Postman - тестирование API DaData (с нуля до результатов)
🔗 Postman: навык тестирования REST API за вечер
🔗 Знакомство с GraphQL на практике через Postman
Знание Postman — это не просто навык, а шаг к карьерному росту!
Он поможет вам разбираться в API на практике, уверенно работать с интеграциями и открыть двери в работу с Backend-командами 🤩
#ИнтеграцииGA
Прежде чем писать детализированный интеграционный Use Case, настоятельно рекомендую протестировать API, чтобы понять, как он работает, и убедиться, что документация соответствует реальности.
👉 Проверять важно только те методы, которые необходимы для работы системы.
Вообще всё по API-документации проверять не нужно.
Исследовательское тестирование API позволяет:
✅ Понять поведение API, особенно момент с работой авторизации запросов.
✅ Выявить расхождения между документацией и фактической реализацией API.
✅ Определить, какие данные реально передаются и принимаются.
✅ Понять, как API обрабатывает ошибки и исключения; найти то, что не задокументировано, чтобы продумать обработки на свои "узкие места" в сценарии.
🟠 Postman — главный инструмент аналитика для работы с API и проведения его исследовательского тестирования. А также один из ключевых навыков в резюме СА.
Если вы хотите работать с Backend-командами и понимать API, то без него никуда.
Он помогает проверять, как работают API-методы, не написав ни одной строчки кода.
С помощью Postman можно проверять:
+ REST API
+ GraphQL
+ gRPC
+ WebSocket
и другие виды API.
Чтобы познакомиться с инструментом в деле, предлагаю поработать с этими практическими руководствами:
Знание Postman — это не просто навык, а шаг к карьерному росту!
Он поможет вам разбираться в API на практике, уверенно работать с интеграциями и открыть двери в работу с Backend-командами 🤩
#ИнтеграцииGA
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥14❤5👍4
2_GetAnalyst_Интеграции_BookingGA_Unisender_Авторассылка.png
575.2 KB
Чтобы сделать четкую и структурированную постановку задачи на интеграцию - технический Use Case (UC), сначала надо изучить архитектуру проекта.
👉 Это помогает:
1. Явно определять участников UC на каждом шаге
2. Понимать где, когда и какой API вызывать
3. Наглядно видеть потоки данных
Из огромной схемы архитектуры проекта #BookingGA, сделанной в рамках этой публикации, я выделила часть, которая связана с задачей:
Подключить Unisender, чтобы пользователи подписывались и получали рассылку по новым и выгодным объектам недвижимости в выбранном городе.
Далее обзорно рассказываю, как будут "ходить" запросы и данные по архитектуре для реализации задачи.
UC 1: Подписка на рассылку
1. Пользователь с Frontend подписывается на рассылку.
2. Frontend отправляет REST API запрос на подписку в Backend (API Gateway).
3. API Gateway перенаправляет запрос на сервис авторизации для проверки валидности токена.
Если успешно, то API Gateway проксирует запрос на сервис Управления Пользователями (УП), чтобы включить настройку.
4. Сервис УП сохраняет изменения настроек в своей БД и отправляет сообщение (JSON) в Kafka о новом подписчике.
Асинхронно, в фоновом режиме, Сервис Уведомлений:
4.1. Читает сообщение о подписке из Kafka.
4.2. Уточняет лист рассылок по БД, в который внести пользователя.
4.3. Отправляет запрос на подписку пользователя в Unisender.
4.4. Сохраняет в БД результат и делает отметку в Kafka об успешной обработке.
5. Сервис УП возвращает ответ об успешном включении подписки на API Gateway.
6. API Gateway возвращает ответ на Frontend, который отражает результат пользователю.
UC 2: Авторассылка новостей подписчикам
Начинается со срабатывания крона (задачи по расписанию), а далее расскажу в детальной постановке задачи 😉
Дополнительно:
Только после понимания как "ходят" данные в архитектуре, мы можем переходить к постановке задач на интеграции 🙌
#ИнтеграцииGA
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥13👍6❤🔥3❤3
🔑 Виды авторизации в API: что нужно знать? 🔑
Авторизация в API помогает убедиться, что только те, кто имеет соответствующие права, могут получить доступ к данным или функциям системы.
Зачем нужна авторизация?
1️⃣ Защищает данные от утечек данных.
2️⃣ Исключает несанкционированный доступ к API, из-за которого могут украсть данные или записать “грязные” данные в систему.
3️⃣ Разграничивает права доступа (например, чтение данных vs редактирование).
4️⃣ Помогает отслеживать действия каждого клиента API.
Основные виды авторизации разобрала в слайдах к посту:
👍 API Key
👌 Basic Auth
❤️ Bearer Token
🦄 JWT (JSON Web Token)
🔥 OAuth 2.0
А какие способы авторизации используются в ваших проектах и интеграциях?
Делитесь в комментариях и ставьте реакции, соответствующие способу! 😊
#ИнтеграцииGA
Авторизация в API помогает убедиться, что только те, кто имеет соответствующие права, могут получить доступ к данным или функциям системы.
Зачем нужна авторизация?
1️⃣ Защищает данные от утечек данных.
2️⃣ Исключает несанкционированный доступ к API, из-за которого могут украсть данные или записать “грязные” данные в систему.
3️⃣ Разграничивает права доступа (например, чтение данных vs редактирование).
4️⃣ Помогает отслеживать действия каждого клиента API.
Основные виды авторизации разобрала в слайдах к посту:
👍 API Key
👌 Basic Auth
❤️ Bearer Token
🦄 JWT (JSON Web Token)
🔥 OAuth 2.0
А какие способы авторизации используются в ваших проектах и интеграциях?
Делитесь в комментариях и ставьте реакции, соответствующие способу! 😊
#ИнтеграцииGA
🔥29❤16💯7👍5👌1
Часто аналитики сталкиваются с тем, что интеграционные задачи кажутся запутанными, а требования формируются «на ощупь». Ошибки в этом процессе могут привести к бесконечным доработкам и конфликтам в команде.
Чтобы системно подходить к работе с интеграциями, разобраться в особенностях анализа API и научиться эффективно ставить задачи, мы готовим для вас практический вебинар:
💥 Задача на Интеграцию: от Postman до требований в Confluence
План:
1. Интеграции: порядок работы над задачами
2. Знакомство с задачей и анализ API-документации
3. Основы REST API: практика в Postman (+ мини-практика с GraphQL и WebSocket 😏)
4. Разработка интеграционного Use Case
5. UML-диаграммы + архитектурные схемы и их роль в требованиях
6. Формирование постановки задачи в Confluence
Эта практика — ваша возможность получить структурированные знания по интеграциям, освоить инструменты работы с API и уверенно двигаться дальше в профессии системного аналитика 💪
Регистрируйтесь, чтобы не пропустить!
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥21❤9👍4
Март 🌸 🥰❤️🔥 Спасибо, что такой теплый, душевный и радостный!
Коллеги, искренне благодарю, что делитесь своими изменениями.
Даже пара строк "Я сделал...", "У меня получилось...", "Внедрил в проекте...", "Оффер 🕺💃" вдохновляют и вызывают чувство радости и гордости!
Всё читаю.
Всё вижу.
Всех помню!
#студентыGetAnalyst
Коллеги, искренне благодарю, что делитесь своими изменениями.
Даже пара строк "Я сделал...", "У меня получилось...", "Внедрил в проекте...", "Оффер 🕺💃" вдохновляют и вызывают чувство радости и гордости!
Всё читаю.
Всё вижу.
Всех помню!
#студентыGetAnalyst
Please open Telegram to view this post
VIEW IN TELEGRAM
Please open Telegram to view this post
VIEW IN TELEGRAM
❤22🔥7👍2😁2
Postman_Практическое_руководство_с_примером_API_Unisender_от_GetAnalyst.pdf
13.2 MB
🧑🔬🟠 Пошаговое руководство: как тестировать API Unisender в Postman 🟠🧑🔬
Пополняем ваше портфолио в Postman коллекцией API-запросов к открытому API Unisender.
Подготовила пошаговое руководство, которое поможет:
🔹 разобраться, как работает API Unisender на практике, даже если вы никогда не пользовались Postman;
🔹 увидеть, как API-запросы соотносятся с UI личного кабинета Unisender;
🔹 понять, что важно при вызове методов API Unisender, чтобы сделать интеграцию к этой системе.
В руководстве вы найдете:
✅ Начало работы в Postman: регистрация аккаунта и вход
✅ Создание Workspace и Collections для работы
✅ Регистрация аккаунта во внешней системе Unisender для получения доступа к API
✅ Тестирование API Unisender
Актуально как для тех, кто еще ни разу не работал с Postman, так и для тех, кто с ним работает постоянно.
💡❗️Опытным аналитикам обратить внимание:
1. Метод sendEmail поддерживает очень длинный URL — это важно учитывать при интеграции.
2. Хотя в гайде показала только POST-запросы, все методы также работают как GET — попробуйте.
👉 Сохраняйте гайд, пробуйте выполнить практику и делитесь результатами!
Ссылки на ваши Postman-коллекции по итогам выполнения всех шагов руководства буду рада видеть в комментариях 😉
#ИнтеграцииGA
Пополняем ваше портфолио в Postman коллекцией API-запросов к открытому API Unisender.
Подготовила пошаговое руководство, которое поможет:
🔹 разобраться, как работает API Unisender на практике, даже если вы никогда не пользовались Postman;
🔹 увидеть, как API-запросы соотносятся с UI личного кабинета Unisender;
🔹 понять, что важно при вызове методов API Unisender, чтобы сделать интеграцию к этой системе.
В руководстве вы найдете:
✅ Начало работы в Postman: регистрация аккаунта и вход
✅ Создание Workspace и Collections для работы
✅ Регистрация аккаунта во внешней системе Unisender для получения доступа к API
✅ Тестирование API Unisender
Актуально как для тех, кто еще ни разу не работал с Postman, так и для тех, кто с ним работает постоянно.
💡❗️Опытным аналитикам обратить внимание:
1. Метод sendEmail поддерживает очень длинный URL — это важно учитывать при интеграции.
2. Хотя в гайде показала только POST-запросы, все методы также работают как GET — попробуйте.
👉 Сохраняйте гайд, пробуйте выполнить практику и делитесь результатами!
Ссылки на ваши Postman-коллекции по итогам выполнения всех шагов руководства буду рада видеть в комментариях 😉
#ИнтеграцииGA
🔥16❤🔥4❤4👌1💯1
Предзапись на практическую программу Интеграции завершается сегодня
🗓 Старт: 2 апреля 2025
🎁 До 24 марта скидка + доп. обучение по БД в подарок
🔗 Подробности и регистрация
В программе:
◽️ 10 живых онлайн-встреч
◽️ Работа над ОДНИМ проектом в течение всего обучения
◽️ Разбор всех этапов проектирования интеграций от А до Я на его примере
◽️ Возможность задать вопросы и получить обратную связь сразу
Ключевые темы:
🔸 определение точек интеграций в сложной системе,
🔸 REST API, GraphQL, SOAP API и другие способы интеграции систем,
🔸 работа в Postman,
🔸 архитектура систем, нотация C4,
🔸 интеграционные Use Case,
🔸 нотация UML,
🔸 маппинг данных,
🔹 ведение документации в Confluence,
🔹 создание и распределение задач на разработчиков.
Вопросы по обучению можно задать @getanalyst или на сайте.
Мы свяжемся с вами, проконсультируем по вопросам и актуальности программы для вас.
🗓 Старт: 2 апреля 2025
На проекте удаётся прожить самый настоящий опыт, со всеми “подводными камнями”, которые встречаются в реальной работе
В программе:
◽️ 10 живых онлайн-встреч
◽️ Работа над ОДНИМ проектом в течение всего обучения
◽️ Разбор всех этапов проектирования интеграций от А до Я на его примере
◽️ Возможность задать вопросы и получить обратную связь сразу
Ключевые темы:
🔸 определение точек интеграций в сложной системе,
🔸 REST API, GraphQL, SOAP API и другие способы интеграции систем,
🔸 работа в Postman,
🔸 архитектура систем, нотация C4,
🔸 интеграционные Use Case,
🔸 нотация UML,
🔸 маппинг данных,
🔹 ведение документации в Confluence,
🔹 создание и распределение задач на разработчиков.
Вопросы по обучению можно задать @getanalyst или на сайте.
Мы свяжемся с вами, проконсультируем по вопросам и актуальности программы для вас.
Please open Telegram to view this post
VIEW IN TELEGRAM
👍5
💥 Задача на Интеграцию: от Postman до требований в Confluence
Презентация готова. Много дополнительных материалов заготовила, которые вы сможете забрать с занятия и использовать в своей работе.
Это занятие не просто про "погуляли по верхам и разошлись", а про решение реальной задачи, погружение в глубину и передачу вам реального опыта.
👉 За один вечер:
✔️ Разберётесь в процессе работы с интеграциями.
✔️ Освоите на практике в Postman принципы работы с REST API, GraphQL и WebSocket.
✔️ Научитесь анализировать JSON-сообщения.
✔️ Узнаете какие диаграммы и зачем нужны в требованиях.
✔️ Проанализируете схему архитектуры в C4.
✔️ Построите UML Sequence с помощью AI-инструментов.
✔️ Получите шаблон постановки задачи для Confluence.
✔️ Узнаете, как избегать типичных ошибок в проектировании.
-----------------------------------
👉 Подготовка к практике:
Перед эфиром установите Postman и зарегистрируйте аккаунт в нём!
Попробуйте сделать Workspace и первую коллекцию.
Всё остальное покажем онлайн.
Инструкция по Postman с нуля
-----------------------------------
👉 Будет практика, разбор ошибок и ответы на вопросы. Не пропустите!
Please open Telegram to view this post
VIEW IN TELEGRAM
❤15👍9❤🔥4