🟢🟠🟡 Инструменты системного аналитика для тестирования в API 🟢🟠🟡
Проверка API — важная часть работы системного аналитика, особенно при интеграции систем и сервисов, при работе в Backend-команде.
Не всегда API-документация актуальна и отражает все сценарии работы, которые будут использованы в интеграции. Особенно это касается поведения внешней системы при ошибках.
👉 Системному аналитику необходимо убедиться, что API внешней системы будет работать именно так, как описано в документации (если она есть, а если нет - то составить), чтобы затем предоставить информацию разработчикам.
Проверка API внешних систем помогает выявить проблемы в работе внешних систем на ранних стадиях разработки, несоответствия документации реальности, а также проверить полноту данных и доступность сервисов в целом.
Также этап тестирования помогает понимать работу API, чтобы грамотно описывать интеграционные сценарии.
Список инструментов, которые помогают системным аналитикам в тестировании API:
🟠 Postman
🟡 SoapUI
🟣 Insomnia
🟢 Swagger
Подробности в картинках к посту ☝️
#ИнтеграцииGA
Проверка API — важная часть работы системного аналитика, особенно при интеграции систем и сервисов, при работе в Backend-команде.
Не всегда API-документация актуальна и отражает все сценарии работы, которые будут использованы в интеграции. Особенно это касается поведения внешней системы при ошибках.
👉 Системному аналитику необходимо убедиться, что API внешней системы будет работать именно так, как описано в документации (если она есть, а если нет - то составить), чтобы затем предоставить информацию разработчикам.
Проверка API внешних систем помогает выявить проблемы в работе внешних систем на ранних стадиях разработки, несоответствия документации реальности, а также проверить полноту данных и доступность сервисов в целом.
Также этап тестирования помогает понимать работу API, чтобы грамотно описывать интеграционные сценарии.
Список инструментов, которые помогают системным аналитикам в тестировании API:
🟠 Postman
🟡 SoapUI
🟣 Insomnia
🟢 Swagger
Подробности в картинках к посту ☝️
#ИнтеграцииGA
🔥24👍15❤7
GetAnalyst_Postman_Практическое_руководство_с_примером_DaData.pdf
9.5 MB
🔥 Новое практическое руководство по Postman - с нуля до результатов 🔥
Один из первых и основных шагов при работе систеных аналитиков с задачами на интеграции — проверка API внешней системы.
Основной инструмент для тестирования и документирования API: Postman.
Если вы еще не использовали его в работе, хотите освоить или получить дополнительную практику, то я подготовила подробную инструкцию с картинками для вас 🧡
В ней вы найдете следующие API DaData:
▫️ Разбор адреса из строки («стандартизация»)
▫️ Автодополнение при вводе («подсказки»)
▫️ Геокодирование
Эти методы нужно было исследовать для работы с интеграционной задачей на структурирование адреса в проекте #ShipEasyGA.
Больше всех подходит "Автодополнение при вводе («подсказки»)". Его и будем использовать для дальнейшей работы 🙂
#ИнтеграцииGA
Один из первых и основных шагов при работе систеных аналитиков с задачами на интеграции — проверка API внешней системы.
Основной инструмент для тестирования и документирования API: Postman.
Если вы еще не использовали его в работе, хотите освоить или получить дополнительную практику, то я подготовила подробную инструкцию с картинками для вас 🧡
В ней вы найдете следующие API DaData:
▫️ Разбор адреса из строки («стандартизация»)
▫️ Автодополнение при вводе («подсказки»)
▫️ Геокодирование
Эти методы нужно было исследовать для работы с интеграционной задачей на структурирование адреса в проекте #ShipEasyGA.
Больше всех подходит "Автодополнение при вводе («подсказки»)". Его и будем использовать для дальнейшей работы 🙂
#ИнтеграцииGA
❤33🔥18❤🔥6👍6
👉 Пример интеграционного Use Case - технические детали в задачах на интеграции 👉
В одном из предыдущих постов я показала пример Use Case заполнения адреса с использованием внешней системы DaData, без технических деталей. Его пока нельзя передавать в разработку, так как в нем отсутствуют требования к вызываемым методам API внешних систем.
Вопрос, на который я хочу ответить в этом посте:
1. В интеграционных сценариях прописывают вызовы API-методов нашего Backend и API внешней системы.
2. Есть обработка ошибок, связанная с проблемами на стороне внешней системы (в том числе ее недоступность, длительное ожидание ответов от нее).
Для полной постановки задачи нужно будет также сделать:
- Описать маппинг данных: БД, наш UI, наш API, API внешней системы.
- Выделить задачи для Frontend и Backend разработчиков.
В картинках к посту выделила места в Use Case, которые добавила после исследования API внешней системы через Postman☝️☝️☝️
#ИнтеграцииGA
В одном из предыдущих постов я показала пример Use Case заполнения адреса с использованием внешней системы DaData, без технических деталей. Его пока нельзя передавать в разработку, так как в нем отсутствуют требования к вызываемым методам API внешних систем.
Вопрос, на который я хочу ответить в этом посте:
Чем отличается обычный Use Case от интеграционного?
1. В интеграционных сценариях прописывают вызовы API-методов нашего Backend и API внешней системы.
2. Есть обработка ошибок, связанная с проблемами на стороне внешней системы (в том числе ее недоступность, длительное ожидание ответов от нее).
Для полной постановки задачи нужно будет также сделать:
- Описать маппинг данных: БД, наш UI, наш API, API внешней системы.
- Выделить задачи для Frontend и Backend разработчиков.
В картинках к посту выделила места в Use Case, которые добавила после исследования API внешней системы через Postman☝️☝️☝️
#ИнтеграцииGA
❤32👍7❤🔥3👎2
Предзапись на практическую программу Интеграции завершается сегодня
🎓 Старт с 25 сентября
🎁 До 19 сентября скидка + доп. курс по БД в подарок
🔗 Подробности и регистрация
Участников ждёт:
◽️ 10 живых онлайн-встреч
◽️ Работа над ОДНИМ проектом в течение всей программы
◽️ Разбор всех этапов проектирования интеграций от А до Я на его примере
◽️ Возможность задать вопросы и получить обратную связь от экспертов сразу
Ключевые темы:
🔸 определение точек интеграций в сложной системе,
🔸 REST API, GraphQL, SOAP API и другие способы интеграции систем,
🔸 работа в Postman,
🔸 архитектура систем, нотация C4,
🔸 интеграционные Use Case, нотация UML,
🔸 маппинг данных,
🔹 ведение документации в Confluence,
🔹 создание и распределение задач на разработчиков.
Вопросы по обучению можно задать @getanalyst или заполнить анкету предзаписи на сайте. Мы свяжемся с вами, и проконсультируем по вопросам и актуальности программы для вас.
На проекте удаётся прожить самый настоящий опыт, со всеми “подводными камнями”, которые встречаются в реальной работе
Участников ждёт:
◽️ 10 живых онлайн-встреч
◽️ Работа над ОДНИМ проектом в течение всей программы
◽️ Разбор всех этапов проектирования интеграций от А до Я на его примере
◽️ Возможность задать вопросы и получить обратную связь от экспертов сразу
Ключевые темы:
🔸 определение точек интеграций в сложной системе,
🔸 REST API, GraphQL, SOAP API и другие способы интеграции систем,
🔸 работа в Postman,
🔸 архитектура систем, нотация C4,
🔸 интеграционные Use Case, нотация UML,
🔸 маппинг данных,
🔹 ведение документации в Confluence,
🔹 создание и распределение задач на разработчиков.
Вопросы по обучению можно задать @getanalyst или заполнить анкету предзаписи на сайте. Мы свяжемся с вами, и проконсультируем по вопросам и актуальности программы для вас.
Please open Telegram to view this post
VIEW IN TELEGRAM
👍10🔥3❤2
Если меня спросят сколько диаграмм есть в разработке, и сколько я реально применяю на практике как системный аналитик, то числа будут сильно отличаться.
На практике я использую всего несколько диаграмм:
💎 UML Sequence - для описания интеграционных сценариев
💎 ER-диаграмма - для проектирования БД, не путать с UML-диаграммой классов
💎 C4 - для проектирования архитектуры (альтернатива - ArchiMate)
💎 BPMN - для описания бизнес-процессов
💎 Диаграмма состояний (статусная модель) - из нотации UML, но не всегда строго по ней делаю
Всё остальное не использую, либо использовала 1-2 раза за всё время после университета.
Когда начала писать этот пост, то хотела перейти к рассказу о UML Sequence, но поняла, что у меня есть важный вопрос к вам.
Коллеги, проголосуйте за диаграммы, которые вы используете в работе, пожалуйста.
И поделитесь в комментариях, если чего-то не учла, и вы этим реально сейчас пользуетесь на работе 👇👇👇
На практике я использую всего несколько диаграмм:
💎 UML Sequence - для описания интеграционных сценариев
💎 ER-диаграмма - для проектирования БД, не путать с UML-диаграммой классов
💎 C4 - для проектирования архитектуры (альтернатива - ArchiMate)
💎 BPMN - для описания бизнес-процессов
💎 Диаграмма состояний (статусная модель) - из нотации UML, но не всегда строго по ней делаю
Всё остальное не использую, либо использовала 1-2 раза за всё время после университета.
Когда начала писать этот пост, то хотела перейти к рассказу о UML Sequence, но поняла, что у меня есть важный вопрос к вам.
Коллеги, проголосуйте за диаграммы, которые вы используете в работе, пожалуйста.
И поделитесь в комментариях, если чего-то не учла, и вы этим реально сейчас пользуетесь на работе 👇👇👇
❤🔥18👍8❤4