2 совета по интеграциям для аналитиков На днях я давала письменное мини-интервью (выйдет оно уже завтра, кстати). В процессе пришло осознание, что я соскучилась по блогу и по возможности делиться с вами чем-то. И пока меня переполняла радость от этого, попался очень классный вопрос, который захотелось раскрыть тут. Какой совет ты дала бы аналитикам, которые впервые сталкиваются с интеграциями? За годы обучения аналитиков от intern до middle, да и на старте своего пути в СА, от слова интеграции мне, как и моим менти, становилось в начале как-то не по себе. От таких вопросов на собесе поднимался ком в горле, а при виде таких задач на работе сразу появлялась паника. Надеюсь, 2 этих пункта помогут проходящим тот же путь не бояться этой темы и справляться с такими задачами быстрее: 1️⃣Любая дока на интеграцию +- однотипна Какой бы способ интеграции вы ни выбрали (брокеры, api, на уровне БД или другие), всегда будет 2 пункта, которые нужно описать аналитику в постановке: 🔸как к системе X обратиться: - какие данные передать Ex.: названия параметров, их формат, обязательность, пример структуры данных (JSON, пр.) - откуда эти данные взять в вашей системе Ex.: рассчитать, достать из БД, взять из ответа от другой системы. - как к системе X достучаться Ex.: вызвать эндпоинт, отправить сообщение в топик или сделать запрос к таблице. 🔸как обработать ответ от системы X: - какие данные она передаст Ex.: названия параметров, их формат, обязательность, пример структуры (JSON, пр.) - какой ответ будет значить успех, а какие – ошибку (❗️важно описать всевозможные альтернативные и исключающие сценарии) Ex.: опираемся на http status code на 2, 4, 5xx или на какие-то значения параметров в ответе - как тот или иной ответ повлияет на дальнейший флоу в вашей системе: что она дальше должна сделать Ex.: изменить статус в БД, залогировать ошибку, отобразить что-то на UI, отправить запрос в другую систему. 2️⃣Практика – это ключевое в качественном изучении интеграций. К сожалению, если просто читать инфу или слушать вебинары, вряд ли получится действительно приобрести навык описания интеграций. Нужно делать руками, начать описывать свои собственные интеграции. Я это осознала на собственном опыте. - Круто, если есть возможность взять задачи на своем проекте и сразу попробовать и проревьюить с более опытными аналитиками или разработчиками. - Если есть желание пойти через обучение, то нужно обязательно использовать возможность выполнять практические задания именно с получением обратной связи. - Если и то, и то недоступно, можно попробовать начать самому. Взять любую открытую API, придумать себе простой кейс, в котором нужна будет интеграция с любым из этих API, и набросать доку. Например, UML sequence и маппинг данных (см. совет 1). А какие бы вы советы дали новичкам в теме интеграций?