🔐 Виды авторизации в 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
❤43🔥20👍9🦄3👌2
Я стараюсь быть там, где вдохновляют и поддерживают, а не тратят время на пустые разговоры и обсуждение других.
Собираю вокруг себя людей, кто про то же.
Встречаясь с людьми, я хочу:
+ делиться идеями и мечтами
+ слушать их от своих собеседников
+ обсуждать планы и результаты на пути к ним
В таком окружении цели становятся ближе, идеи ярче, и появляется ощущение, что всё возможно.
И неважно, говорим мы о людях, с которыми знакомы, или о тех, за кем следим в соцсетях.
Все, кто вокруг, меняют нас в ту или иную сторону.
Рост происходит благодаря людям, которыми себя окружаешь 🌱
Собираю вокруг себя людей, кто про то же.
Встречаясь с людьми, я хочу:
+ делиться идеями и мечтами
+ слушать их от своих собеседников
+ обсуждать планы и результаты на пути к ним
В таком окружении цели становятся ближе, идеи ярче, и появляется ощущение, что всё возможно.
И неважно, говорим мы о людях, с которыми знакомы, или о тех, за кем следим в соцсетях.
Все, кто вокруг, меняют нас в ту или иную сторону.
Рост происходит благодаря людям, которыми себя окружаешь 🌱
❤68🔥15🥰6❤🔥4👌4😁2💯2👍1
GetAnalyst_Use_Cases_Обычные_VS_Интеграционные.pdf
1.1 MB
⚙️ Use Cases: обычные VS интеграционные ⚙️
Use Case — это:
✅ детализированные функциональные требования;
✅ описание того, как пользователь взаимодействует с системой для достижения определённой цели;
✅ сценарий, который показывает шаги, выполняемые пользователем и системой в процессе выполнения задачи;
✅ алгоритм работы системы.
Стандартный шаблон Use Case включает:
▪ Предусловие
▪ Роли пользователей
▪ Приложения и системы
▪ Входные данные
▪ Основной сценарий
▪ Обработка ошибок и альтернативные сценарии
▪ Ожидаемый результат
В случае интеграций, Use Case дополняется:
▪ техническими деталями по вызовам API методов, которые аналитику важно прописать в постановке задачи,
▪ а также маппингом данных.
Интеграции — это не просто "еще одна задача".
Это серьезная работа по анализу взаимосвязей БД + Функций + UI/UX + API нашей и внешних систем, который требует нашего опыта, внимания и профессионализма 🙌
Мини-книгу про отличия обычных Use Case от интеграционных прикрепила к посту 🤝
#ИнтеграцииGA
Use Case — это:
Стандартный шаблон Use Case включает:
▪ Предусловие
▪ Роли пользователей
▪ Приложения и системы
▪ Входные данные
▪ Основной сценарий
▪ Обработка ошибок и альтернативные сценарии
▪ Ожидаемый результат
В случае интеграций, Use Case дополняется:
▪ техническими деталями по вызовам API методов, которые аналитику важно прописать в постановке задачи,
▪ а также маппингом данных.
Интеграции — это не просто "еще одна задача".
Это серьезная работа по анализу взаимосвязей БД + Функций + UI/UX + API нашей и внешних систем, который требует нашего опыта, внимания и профессионализма 🙌
Мини-книгу про отличия обычных Use Case от интеграционных прикрепила к посту 🤝
#ИнтеграцииGA
Please open Telegram to view this post
VIEW IN TELEGRAM
❤26👏16🔥8⚡3👍3😁2🎉1
Предзапись на практическую программу Интеграции завершается в среду
🎓 Старт: 25 декабря 2024
🗓 Первая онлайн-встреча: 15 января 2025
🎁 До 18 декабря скидка + доп. обучение по БД в подарок
🔗 Подробности и регистрация
В программе:
◽️ 10 живых онлайн-встреч
◽️ Работа над ОДНИМ проектом в течение всего обучения
◽️ Разбор всех этапов проектирования интеграций от А до Я на его примере
◽️ Возможность задать вопросы и получить обратную связь сразу
Ключевые темы:
🔸 определение точек интеграций в сложной системе,
🔸 REST API, GraphQL, SOAP API и другие способы интеграции систем,
🔸 работа в Postman,
🔸 архитектура систем, нотация C4,
🔸 интеграционные Use Case,
🔸 нотация UML,
🔸 маппинг данных,
🔹 ведение документации в Confluence,
🔹 создание и распределение задач на разработчиков.
Вопросы по обучению можно задать @getanalyst или на сайте.
Мы свяжемся с вами, проконсультируем по вопросам и актуальности программы для вас.
🗓 Первая онлайн-встреча: 15 января 2025
На проекте удаётся прожить самый настоящий опыт, со всеми “подводными камнями”, которые встречаются в реальной работе
В программе:
◽️ 10 живых онлайн-встреч
◽️ Работа над ОДНИМ проектом в течение всего обучения
◽️ Разбор всех этапов проектирования интеграций от А до Я на его примере
◽️ Возможность задать вопросы и получить обратную связь сразу
Ключевые темы:
🔸 определение точек интеграций в сложной системе,
🔸 REST API, GraphQL, SOAP API и другие способы интеграции систем,
🔸 работа в Postman,
🔸 архитектура систем, нотация C4,
🔸 интеграционные Use Case,
🔸 нотация UML,
🔸 маппинг данных,
🔹 ведение документации в Confluence,
🔹 создание и распределение задач на разработчиков.
Вопросы по обучению можно задать @getanalyst или на сайте.
Мы свяжемся с вами, проконсультируем по вопросам и актуальности программы для вас.
Please open Telegram to view this post
VIEW IN TELEGRAM
❤4👏3🔥2
Интеграционный_UseCase_Автоматическое_создание_задач_в_Todolist.pdf
300 KB
🎲 Интеграционный Use Case: заполненный шаблон требований 🎲
В посте о проекте я описала общий процесс работы системы #EventTasksGA AS IS (как есть) и требования к его автоматизации.
За этим небольшим текстом с требованиями скрывается:
+ несколько независимых процессов работы пользователей,
+ десятки задач для разработчиков Backend и Frontend,
+ а также технические требования для их реализации.
👉 Чтобы показать, как описывать интеграционный Use Case, я взяла ключевой процесс:
“Автоматическое создание задач в Todoist после успешной оплаты заказа, без автоназначения ответственного”.
А так как я предпочитаю показывать суровую реальность… 🙈
Заполнила для вас основную часть шаблона постановки задачи на интеграцию в Confluence.
Маппинги, требования к интеграционным методам и брокеру еще впереди 😉
Заполненный шаблон с примером интеграционного Use Case прикреплен к посту 🎀
#ИнтеграцииGA
В посте о проекте я описала общий процесс работы системы #EventTasksGA AS IS (как есть) и требования к его автоматизации.
За этим небольшим текстом с требованиями скрывается:
+ несколько независимых процессов работы пользователей,
+ десятки задач для разработчиков Backend и Frontend,
+ а также технические требования для их реализации.
👉 Чтобы показать, как описывать интеграционный Use Case, я взяла ключевой процесс:
“Автоматическое создание задач в Todoist после успешной оплаты заказа, без автоназначения ответственного”.
А так как я предпочитаю показывать суровую реальность… 🙈
Заполнила для вас основную часть шаблона постановки задачи на интеграцию в Confluence.
Маппинги, требования к интеграционным методам и брокеру еще впереди 😉
Заполненный шаблон с примером интеграционного Use Case прикреплен к посту 🎀
#ИнтеграцииGA
👍22❤10❤🔥6😁3
Встречаемся завтра на практике, в прямом эфире:
Подготовка:
1. Зарегистрируйтесь в Postman.
2. Если вы ни разу не пользовались Postman, попробуйте создать Workspace и коллекцию. Инструкция по Postman здесь. Всё остальное покажу 🤝
3. Откройте Postman перед началом занятия.
Рекомендую подключаться к эфиру с компьютера, т.к. будем вместе, в прямом эфире, тестировать API.
Эта практика - ваша возможность сделать огромный шаг в понимании работы с API и интеграциями!
Регистрируйтесь, чтобы не пропустить!
Please open Telegram to view this post
VIEW IN TELEGRAM
❤11
GetAnalyst_UML_Activity_Запрос_сброса_пароля.png
110.9 KB
💥 UML-Sequence: основная диаграмма для интеграций 💥
Интеграционный UseCase написан. Но иногда в нем много текста. Слишком много текста 😁 А разработчики много читать не любят.
Для быстрого понимания “о чем тут вообще” помогают картинки и схемы.
Особенно, когда речь идет о сложных интеграционных сценариях.
➡️ UML Sequence
Прекрасным дополнением к интеграционному Use Case служит UML диаграмма последовательности.
Диаграмма помогает быстрее разобраться не только в последовательности шагов, но и во взаимосвязях между компонентами системы, что особенно ценно при разработке и тестировании интеграций.
➡️ UML Activity
Визуально похожа на блок-схему.
Помогает показывать алгоритм работы системы.
Но используется реже, чем UML Sequence.
Диаграммы могут являться как дополнением, так и заменой текстового описания.
Но текст алгоритмов всё же лучше держать рядом с диаграммами, как показазывает опыт.
Основные инструменты для построения UML-диаграмм:
Графические редакторы
🔸 Draw.io
🔸 Microsoft Visio
🔸 Lucidchart
🔸 Miro
Для создания диаграмм через код
🔸 PlantUML
🔸 MermaidChart
🖼 На картинках к посту показала обе диаграммы — UML Sequence и UML Activity.
Пример для процесса сброса пароля:
1. пользователь на переходит к экрану "Забыли пароль?",
2. вводит свой email,
3. получает письмо со ссылкой для сброса пароля на email.
👉 Обе созданы через код в PlantUML и описывают один и тот же процесс.
👉 Как читать:
+ UML Sequence: читайте строки по порядку, сверху-вниз, даже если следующая строка находится правее или левее.
+ UML Activity: двигайтесь сверху вниз, а при разветвлении (ромбы/многоугольники) сначала завершите читать одну ветку, затем другую.
#ИнтеграцииGA
Интеграционный UseCase написан. Но иногда в нем много текста. Слишком много текста 😁 А разработчики много читать не любят.
Для быстрого понимания “о чем тут вообще” помогают картинки и схемы.
Особенно, когда речь идет о сложных интеграционных сценариях.
➡️ UML Sequence
Прекрасным дополнением к интеграционному Use Case служит UML диаграмма последовательности.
UML-Sequence
– это тип диаграммы, который показывает, как компоненты в системе взаимодействуют друг с другом в хронологическом порядке.
Диаграмма помогает быстрее разобраться не только в последовательности шагов, но и во взаимосвязях между компонентами системы, что особенно ценно при разработке и тестировании интеграций.
➡️ UML Activity
UML-Activity
помогает визуализировать последовательность действий в процессе работы системы, показывая не только шаги, но и ветвления, условия, циклы.
Может показывать системы и роли пользователей.
Визуально похожа на блок-схему.
Помогает показывать алгоритм работы системы.
Но используется реже, чем UML Sequence.
Диаграммы могут являться как дополнением, так и заменой текстового описания.
Но текст алгоритмов всё же лучше держать рядом с диаграммами, как показазывает опыт.
Основные инструменты для построения UML-диаграмм:
Графические редакторы
🔸 Draw.io
🔸 Microsoft Visio
🔸 Lucidchart
🔸 Miro
Для создания диаграмм через код
🔸 PlantUML
🔸 MermaidChart
🖼 На картинках к посту показала обе диаграммы — UML Sequence и UML Activity.
Пример для процесса сброса пароля:
1. пользователь на переходит к экрану "Забыли пароль?",
2. вводит свой email,
3. получает письмо со ссылкой для сброса пароля на email.
👉 Обе созданы через код в PlantUML и описывают один и тот же процесс.
👉 Как читать:
+ UML Sequence: читайте строки по порядку, сверху-вниз, даже если следующая строка находится правее или левее.
+ UML Activity: двигайтесь сверху вниз, а при разветвлении (ромбы/многоугольники) сначала завершите читать одну ветку, затем другую.
#ИнтеграцииGA
🔥24❤15👍6👌3👏1
📕 Подборка материалов по REST API, GraphQL, gRPC 📕
Уже сегодня на онлайн-практике будем изучать все виды API с использованием Postman.
А пока предлагаю познакомиться с нашими дополнительными материалами к занятию и посмотреть их до/после практики, чтобы закрепить результат 👇
⚡ REST API (Representational State Transfer)
Использует HTTP-протокол и основывается на концепциях ресурсов и методов (GET, POST, PUT, PATCH, DELETE и другие).
Широко используется для веб-, мобильных приложений и микросервисной архитектуры.
🔗 Официальная документация
📚 Проектирование REST API: спорные вопросы с проектов и собеседований на системного аналитика (и не только)
📚 Postman: навык тестирования REST API за вечер
📚 Вопросы и ответы по REST API: собеседование на системного аналитика (подкаст)
Пример документации:
Wildberries
⚡ GraphQL
Позволяет клиенту запрашивать только те данные, которые ему необходимы, с помощью декларативного языка запросов.
Удобен для сложных приложений с изменяемыми потребностями в данных, для мобильных приложений и микросервисов с целью оптимизации трафика между клиентом и сервером, который реализует API.
🔗 Официальная документация
📚 GraphQL — знакомство на практике через Postman [пошаговая инструкция]
Пример документации:
Contentful
⚡ gRPC
Использует Protocol Buffers для сериализации данных и поддерживает как синхронные, так и асинхронные вызовы.
Эффективен для микросервисной архитектуры с высокими требованиями к производительности.
Очень много коллег, кто в новых проектах на микросервисной архитектуре его использует сразу, даже не рассматривая REST.
🔗 Официальная документация
📚 gRCP vs REST - что выбрать для проекта (подкаст + материалы)
Пример документации:
Dropbox от Google
#ИнтеграцииGA
Уже сегодня на онлайн-практике будем изучать все виды API с использованием Postman.
А пока предлагаю познакомиться с нашими дополнительными материалами к занятию и посмотреть их до/после практики, чтобы закрепить результат 👇
⚡ REST API (Representational State Transfer)
Использует HTTP-протокол и основывается на концепциях ресурсов и методов (GET, POST, PUT, PATCH, DELETE и другие).
Широко используется для веб-, мобильных приложений и микросервисной архитектуры.
📚 Проектирование REST API: спорные вопросы с проектов и собеседований на системного аналитика (и не только)
📚 Postman: навык тестирования REST API за вечер
📚 Вопросы и ответы по REST API: собеседование на системного аналитика (подкаст)
Пример документации:
Wildberries
⚡ GraphQL
Позволяет клиенту запрашивать только те данные, которые ему необходимы, с помощью декларативного языка запросов.
Удобен для сложных приложений с изменяемыми потребностями в данных, для мобильных приложений и микросервисов с целью оптимизации трафика между клиентом и сервером, который реализует API.
📚 GraphQL — знакомство на практике через Postman [пошаговая инструкция]
Пример документации:
Contentful
⚡ gRPC
Использует Protocol Buffers для сериализации данных и поддерживает как синхронные, так и асинхронные вызовы.
Эффективен для микросервисной архитектуры с высокими требованиями к производительности.
Очень много коллег, кто в новых проектах на микросервисной архитектуре его использует сразу, даже не рассматривая REST.
📚 gRCP vs REST - что выбрать для проекта (подкаст + материалы)
Пример документации:
Dropbox от Google
#ИнтеграцииGA
Please open Telegram to view this post
VIEW IN TELEGRAM
👏12❤10🔥5👍1
Коллеги, еще раз огромное и искреннее спасибо вам за участие во вчерашней онлайн-практике по REST, GraphQL и gRPC для интеграций! ❤️
Это был последний прямой эфир в 2024 году.
Проведен в качестве открытого урока практической программы Интеграции систем.
И прошел он невероятно! 😍
Что успели:
1️⃣ Протестировали три разных вида API в Postman: REST API, GraphQL и gRPC.
2️⃣ Обсудили, почему аналитикам важно уметь работать с Postman: задачи интеграции часто содержат скрытые нюансы, а документация далеко не всегда охватывает все детали. Поэтому тестируем через него.
3️⃣ Вместе восхищались особенностям, которые есть в GraphQL и gRPC по сравнению с REST API.
4️⃣ Разобрались в различиях между протоколами: например, помимо привычного HTTP/1.1 для REST API, изучили использование HTTP/2 в gRPC, его принципы работы и преимущества.
5️⃣ Обсудили множество вопросов, связанных не только с использованием, но и с проектированием методов REST API и GraphQL. В дополнение, коллегам была передана моя статья о работе с файлами .proto для gRPC.
Мы провели в эфире 3.5 часа.
На одном дыхании.
С огромным количеством положительных эмоций, пользы и результатов.
Разобрали все вопросы из онлайн-чата.
----------------------------
‼️ Для тех, кто не был онлайн, либо отключился раньше:
+ мы пришлём запись в субботу утром всем, кто был зарегистрирован
+ запись будет доступна с 21 до 23 декабря
+ регистрация на получение записи будет открыта до пятницы (тем, кто был зарегистрирован на основной эфир, повторно регистрироваться НЕ надо)
👉 Регистрация тут
----------------------------
У меня лучшая аудитория!
Активная, осознанная и вовлеченная.
Любящая свое дело.
И не меньше чем я увлеченная системной аналитикой!
Спасибо вам за яркие впечатления и проделанную работу! ❤️🔥❤️🔥
Это был последний прямой эфир в 2024 году.
Проведен в качестве открытого урока практической программы Интеграции систем.
И прошел он невероятно! 😍
Что успели:
1️⃣ Протестировали три разных вида API в Postman: REST API, GraphQL и gRPC.
2️⃣ Обсудили, почему аналитикам важно уметь работать с Postman: задачи интеграции часто содержат скрытые нюансы, а документация далеко не всегда охватывает все детали. Поэтому тестируем через него.
3️⃣ Вместе восхищались особенностям, которые есть в GraphQL и gRPC по сравнению с REST API.
4️⃣ Разобрались в различиях между протоколами: например, помимо привычного HTTP/1.1 для REST API, изучили использование HTTP/2 в gRPC, его принципы работы и преимущества.
5️⃣ Обсудили множество вопросов, связанных не только с использованием, но и с проектированием методов REST API и GraphQL. В дополнение, коллегам была передана моя статья о работе с файлами .proto для gRPC.
Мы провели в эфире 3.5 часа.
На одном дыхании.
С огромным количеством положительных эмоций, пользы и результатов.
Разобрали все вопросы из онлайн-чата.
----------------------------
‼️ Для тех, кто не был онлайн, либо отключился раньше:
+ мы пришлём запись в субботу утром всем, кто был зарегистрирован
+ запись будет доступна с 21 до 23 декабря
+ регистрация на получение записи будет открыта до пятницы (тем, кто был зарегистрирован на основной эфир, повторно регистрироваться НЕ надо)
👉 Регистрация тут
----------------------------
У меня лучшая аудитория!
Активная, осознанная и вовлеченная.
Любящая свое дело.
И не меньше чем я увлеченная системной аналитикой!
Спасибо вам за яркие впечатления и проделанную работу! ❤️🔥❤️🔥
❤🔥71🔥20💯4❤3👍2
Если вы знаете инструмент, в котором можно описать диаграмму через код, то на помощь в её разработке приходит Искусственный Интеллект.
ChatGPT - Искусственный Интеллект
PlantUML - Инструмент для описания любых диаграмм UML через код
Инструкция по созданию UML Sequence:
1️⃣ Открой ChatGPT и войди аккаунт
2️⃣ Выполни команду
Работай как опытный системный аналитик.
Сделай код для plantUML, чтобы создать UML Sequence диаграмму.
Не показывай альтернативные сценарии.
Сценарий:
<название сценария>
Пользователи и системы:
<участники сценария>
Описание сценария:
<описание Use Case>
Заполни название сценария и список участников (пользователи, фронтенды, бэкенды, внешние системы, БД).
Скопируй и вставь на место <описание Use Case> детализированный Use Case с описанием сценария интеграции.
Пример Use Case.
Отправь запрос к ChatGPT.
3️⃣ ChatGPT вернет в ответ код диаграммы для PlantUML
4️⃣ Вставь полученный код в PlantUML
5️⃣ Обязательно проверь и скорректируй результат:
5.1. Вручную поправь код по аналогии - это быстрее
5.2. Проси уточнения кода у ChatGPT дополнительными запросами
1. Диаграмма за 3+15 минут, с учетом проверки результатов.
2. Не надо писать код самому.
3. Легко делать правки, т.к. диаграмма через код, и при любых правках всё двигается автоматически.
1. Интеграционный Use Case должен быть описан идеально. Без него диаграмму не сделать, либо будет много правок в придуманном ИИ варианте
2. ChatGPT делает ошибки и за ним надо вносить правки
Рекомендую использовать этот лайфхак только при знании и понимании нотации.
Для тех, кто только изучает UML, рекомендую использовать ИИ для проверок ваших результатов.
#ИнтеграцииGA
Please open Telegram to view this post
VIEW IN TELEGRAM
❤26👍10🔥4🦄3