💥 Интеграции — это понимание того, как система работает “под капотом” 💥

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

И это было ОК! 😃


А потом пришёл "умный и важный" Backend-разработчик и сказал примерно так:

Теперь мы делаем не монолит, где UI + логика + БД в одной кодовой базе.
Теперь у нас Frontend и Backend, которые общаются по API.

И вот тогда я впервые узнала интеграции на минимальном уровне:
➡️ Frontend → Backend


Но настоящий "аттракцион" начался позже, когда появилась задача получать данные из внешней системы 👀

➡️ наш Frontend → наш Backend → внешняя система
➡️ а потом интеграции микросервисов


👉 И самое неприятное тогда было — чувство, когда ты угадываешь, что ждут разработчики...
Было много "танцев на граблях".

С годами интеграций становилось больше: разные API, протоколы, асинхрон, оборудование. И этот тип задач в итоге стал моим самым любимым 🩷

Сейчас я рада делиться своим опытом в интеграциях с вами в GetAnalyst!



Мы открыли предзапись на новый поток практической программы для СА и БА, который проводим в новом летнем формате:

💥💥💥 Интеграции систем

⚪ с 8 июля до 23 сентября — обучение по записям в комфортном вам темпе
🟢 30 сентября — закрытая онлайн-встреча по подготовке к собеседованиям
🟢 с 14 октября до 23 декабря — можете подключиться к онлайн-занятиям и работать с экспертами


🎁🎁🎁 До 3 июля — самый большой набор бонусов за всю историю GetAnalyst:

✅ Расширенный доступ
8/12 месяцев вместо стандартных 6/9

✅ Курс «БД и SQL: продвинутый уровень»
в подарок (обычная стоимость 9 500 руб) — поможет для работы с маппингом

✅ Мини-курс «REST API для аналитиков 3.0»
больше по проектированию API с нуля после основного обучения

🟢 Онлайн-встреча по подготовке к собеседованиям 30 сентября
решаете задачи с реальных интервью в прямом эфире и получаете обратную связь


Результат:

✔️ Описываете интеграционные Use Cases
✔️ Уверенно работаете с API: REST, SOAP, GraphQL, gRPC, WebSocket
✔️ Опыт работы с Postman
✔️ Знаете нотацию C4 для архитектуры
✔️ Понимате асинхрон, в т.ч. брокеры
✔️ Можете сделать задачу на интеграционный REST API метод
✔️ У вас десятки примеров документации, которые можно переиспользовать в работе

Это то, что сейчас спрашивают Middle+ системных аналитиков на собеседованиях, и то, что реально нужно в работе.


💥 Интеграции систем
🔗 Узнать подробнее и записаться


Приглашаем вас получить за лето навык, который даёт уверенность и рост в карьере СА, как раз к периоду активного осеннего найма 🍁🙌


Вопросы? Пишите @getanalyst или info@getanalyst.ru.
Уточним ваш опыт и подскажем, подойдёт ли вам программа 🤝

🧡 10 гайдов по Postman, которые прокачают работу с API 🧡

Документация ≠ реальность.

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

Он заранее уточняет нюансы, которых нет в API-документации внешней системы, чтобы разработчики затем не тратили на это время.


Что важно проверить аналитику при исследовании API:
✅ как работает аутентификация
✅ как выполняются нужные API-методы
✅ какие параметры обязательны
✅ какие поля приходят в JSON-ответе
✅ какие ошибки возвращаются при нештатных ситуациях
✅ как API ведёт себя при некорректных данных, отсутствии доступа или пустом результате


👉 Делюсь подборкой практических руководств по исследованию API внешних систем через Postman:

📹 Postman: навык тестирования REST API за вечер

📚 Тестирование API DaData

📚 Тестирование API Unisender

📚 Тестирование API банка ВТБ

📚 Тестирование API KudaGo и DashaMail

📚 Тестирование API ChatGPT

📚 Практика с настройкой OAuth 2.0 от Mail ru

📚 7 видов аутентификации в API - демо с настройками в Postman

📹 Аутентификация mTLS на практике в Postman

📚 GraphQL API — знакомство на практике Postman


👉 В этих руководствах всё по шагам: с картинками, настройками запросов и примерами.

С ними можно за выходные освоить базовую работу в Postman и пополнить портфолио несколькими коллекциями API-запросов 🙌



🔖 Сохраняйте пост в избранное,
чтобы пройти все руководства и получить реальный опыт в API для работы с задачами на интеграции


#ИнтеграцииGA

📱 GetAnalyst | 💙 VK | 💬 Max

🤯 Разработчик вернул задачу. Я дописала. Снова вернул. Что не так то?! 🤯

Такое часто бывает в интеграционных задачах.

И часто дело не в том, что разработчик «придирается».
Дело в том, что по этой постановке сложно писать код.

Часть решений приходится принимать разработчику самому, и в итоге он начинает делать работу за аналитика — уточнять у прОдукта, дизайнера, QA и других команд, как система должна себя вести.



👉 5 мест, где аналитики чаще всего теряют детали в интеграционных задачах:


1️⃣ «Обработать ошибки» — это не требование, а отписка

👎 Плохо:
«Обработать ошибки внешней системы».

✅ Хорошо:
▫️ при HTTP 401 — обновить токен и повторить запрос
▫️ при HTTP 404 — показать пользователю, что данные не найдены
▫️ при HTTP 500 или timeout — залогировать ошибку и показать сообщение о временной недоступности, если предусмотрен кэш — вернуть данные из кэша по описанным правилам

Без конкретики разработчик может вывести пользователю одно универсальное «Что-то пошло не так» на любую ошибку.
И будет формально прав.
Потому что в требованиях ничего другого не написано.


2️⃣ Нет маппинга данных

👎 «Система передаёт данные пользователя во внешнюю систему».

Какие данные?
Из какого поля?
В каком формате?
Что делать, если значение пустое?

✅ В требованиях должна быть таблица маппинга:
▫️ поле на UI
▫️ поле в API нашей системы
▫️ поле в API внешней системы
▫️ поле в БД, если используется
▫️ тип данных
▫️ обязательность
▫️ правила валидации
▫️ что делать, если null / пусто / некорректный формат

Без этих требований разработчик угадывает как соотносятся данные между частями нашей и внешней системой.
И делает работу за аналитика.


3️⃣ Нет требований к аутентификации и авторизации

👎 «Авторизация через Bearer Token».

А дальше?

✅ Нужно описать:
▫️ где и как получаем токен
▫️ кто настраивает доступы для dev / stage / prod
▫️ где хранятся client_id, client_secret и другие секреты
▫️ когда токен считается истёкшим
▫️ как обновляется токен
▫️ что делать, если токен истёк посреди фоновой джобы
▫️ что делать, если обновить токен не удалось

Аутентификация во внешней системе — это не одна строка в требованиях.

Это отдельная задача с полноценным набором сценариев, которая требует проработки.


4️⃣ Нет Timeout и Retry

👎 Не описали ситуации:
Внешний сервис лёг.
Или отвечает слишком долго.
Или сеть моргнула на 2 секунды.

Что делает наша система?

Если это не описано, разработчик решит сам.

Обычно потом получается так:
запрос висит 30 секунд → падает с ошибкой → пользователь видит белый экран или «Что-то пошло не так».

✅ В требованиях нужно указать:

▫️ timeout на запрос
▫️ количество повторных попыток
▫️ интервал между попытками
▫️ нужен ли backoff
▫️ что делать после исчерпания попыток
▫️ что показываем пользователю
▫️ что логируем
▫️ нужна ли задача на повторную обработку

Интеграции ломаются не только тогда, когда API вернул ошибку.
Иногда он просто не ответил вовремя.


5️⃣ Нет логики при частичном успехе

Это боль всех массовых интеграций:
каталоги, импорт клиентов, обновление статусов, синхронизация заказов.

Например:
Отправили 10 000 записей.
9 847 обработались успешно.
153 упали с ошибкой.

Это успех или провал?

В требованиях нужен явный ответ:

▫️ что считается успешным результатом
▫️ что делать с упавшими записями
▫️ нужно ли повторять обработку
▫️ сколько раз повторять
▫️ кто увидит ошибку
▫️ где будет отчёт
▫️ можно ли продолжать процесс, если часть данных не обработалась

Без этого массовая синхронизация превращается в хаос.



👉 Если этого нет — задача почти гарантированно вернётся на доработку.

И это не потому, что разработчик вредный, а потому что нет требований к обработке ошибок.


#ИнтеграцииGA

📱 GetAnalyst | 💙 VK | 💬 Max