POST_appointments_Записать_питомца_к_врачу_GetAnalyst_Пример_требований.pdf
1.5 MB
📌📚 POST /appointments — пример постановки задачи на REST API метод — выгрузка из Confluence 🔵📋
Пополняю открытую базу знаний GetAnalyst.
Сделала новое полноценное ТЗ на разработку REST API метода "Запись питомца к ветеринару" для проекта #VetCareGA:
Так что теперь у вас есть ещё один образец 🤝
Что внутри:
✅ авторизация и ограничения доступа
✅ 15 вариантов ответа с максимально точными HTTP-кодами (401, 403, 409, 422 ...)
✅ технический алгоритм работы Backend
✅ маппинг данных: запрос ↔ JSON ↔ БД
✅ логирование, метрики и алерты
🖥 Кликабельный прототип UI — можно потыкать, как выглядит экран пользователя, для которого метод
🗄 БД проекта
🕘 30 минут
ушло на постановку задачи с ИИ:
+ генерация
+ детальное ревью результатов и уточнения
+ перенос в Confluence
Работала со своим преднастроенным ИИ-агентом под задачи на REST API. Получилось очень быстро, минимум правок и высокое качество результата сразу.
🔖 Шаблон максимально полный
Забирайте себе, его можно адаптировать под любой метод вашего проекта.
#RestApiGA
📱 GetAnalyst | 💙 VK | 💬 Max
Пополняю открытую базу знаний GetAnalyst.
Сделала новое полноценное ТЗ на разработку REST API метода "Запись питомца к ветеринару" для проекта #VetCareGA:
POST https://api.vetcarega.com/public/v1/appointments
Так что теперь у вас есть ещё один образец 🤝
Что внутри:
✅ авторизация и ограничения доступа
✅ 15 вариантов ответа с максимально точными HTTP-кодами (401, 403, 409, 422 ...)
✅ технический алгоритм работы Backend
✅ маппинг данных: запрос ↔ JSON ↔ БД
✅ логирование, метрики и алерты
🖥 Кликабельный прототип UI — можно потыкать, как выглядит экран пользователя, для которого метод
🗄 БД проекта
🕘 30 минут
ушло на постановку задачи с ИИ:
+ генерация
+ детальное ревью результатов и уточнения
+ перенос в Confluence
Работала со своим преднастроенным ИИ-агентом под задачи на REST API. Получилось очень быстро, минимум правок и высокое качество результата сразу.
Забирайте себе, его можно адаптировать под любой метод вашего проекта.
#RestApiGA
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥14❤9❤🔥2
▫️ Аутентификация (Authentication) — подтверждение, что это действительно тот клиент / пользователь, за кого он себя выдаёт.
Проверяется при входе в систему, когда пользователь предоставляет ключи доступа:
+ логин+пароль
+ токен
Если аутентификация не пройдена, то API должен вернуть ошибку HTTP-401.
▫️ Авторизация (Authorization) — проверка прав аутентифицированного клиента: что ему можно, а что нет.
При выполнении очередного действия в системе, например - удаление мероприятия в календаре, надо проверить, что у него есть права на это (он его создал, оно в его календаре).
Если нет прав, то API должен вернуть ошибку HTTP-403.
👉 Основные механизмы аутентификации:
часть из них описана и показана на примере в Postman в картинках к посту
1️⃣ API-ключ
Руководство Postman: пример с API Unisender (api-key в query-параметрах запроса)
2️⃣ Basic Auth
3️⃣ Bearer Token
4️⃣ JWT (JSON Web Token)
5️⃣ OAuth 2.0
Подробная теория с примерами
Руководство Postman: API Mail.ru
6️⃣ TLS / mTLS
Руководство Postman: пример с API DaData (token + x-secret-key)
Руководство Postman: пример с API ВТБ (логин и пароль в прямом виде)
👉 В требованиях к API-методу обязательно указать:
+ какую схему аутентификации поддерживаем
+ формат токена (JWT, UUID и т.д.)
+ где передавать (заголовок, query-параметры, тело, cookies)
+ список возможных ошибок и их тело (JSON-ответ)
👉 Нужно глубже погрузиться в тему аутентификации и авторизации в API?
🎧 Подкаст и статья
#RestApiGA
Please open Telegram to view this post
VIEW IN TELEGRAM
Please open Telegram to view this post
VIEW IN TELEGRAM
❤14❤🔥5🔥3🦄1
Forwarded from 👩🏻💻 Подкаст Системных Аналитиков | GetAnalyst
🔵 Задача на REST API с технического собеседования: где чаще всего ошибаются системные аналитики 📝🤝
Большинство системных аналитиков уверены, что знают REST API. Но на техническом собеседовании именно в этой задаче бывает больше всего ошибок.
Разбираем реальную задачу с собеседования: проектируем REST API метод для системы технической поддержки — от первого вопроса интервьюеру до обработки ошибок.
🔗 Статья с доп. материалами
После основного разбора — 20+ вопросов с подвохом: текстовый поиск, SQL-инъекции, оптимизация производительности, GET vs POST.
👉 Практика, которая прокачивает реальные навыки системного аналитика.
Видео с демо решения:
⏯ YouTube
⏯ RuTube
⏯ VK Video
⏯ Telegram
Аудио:
⏯ Apple Podcast
⏯ Яндекс.Музыка
⏯ Castbox
⏯ Звук
⏯ Spotify
🚀 GetAnalyst — техническая база системного аналитика
📱 Tg | 💙 ВК | 💬 Max
Большинство системных аналитиков уверены, что знают REST API. Но на техническом собеседовании именно в этой задаче бывает больше всего ошибок.
Разбираем реальную задачу с собеседования: проектируем REST API метод для системы технической поддержки — от первого вопроса интервьюеру до обработки ошибок.
После основного разбора — 20+ вопросов с подвохом: текстовый поиск, SQL-инъекции, оптимизация производительности, GET vs POST.
👉 Практика, которая прокачивает реальные навыки системного аналитика.
Видео с демо решения:
⏯ YouTube
⏯ RuTube
⏯ VK Video
⏯ Telegram
Аудио:
⏯ Apple Podcast
⏯ Яндекс.Музыка
⏯ Castbox
⏯ Звук
⏯ Spotify
🚀 GetAnalyst — техническая база системного аналитика
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥7❤🔥5💯1
Давайте познакомимся поближе 😏🩷
В чате был вопрос:
«А как вы отдыхаете и перезагружаетесь?»
Начну с факта о себе: отдыхать мне пришлось учиться.
И не один раз 😅
Я работаю с 14 лет. И у меня долго была установка:
👉 если не выложилась на 200%, значит плохо поработала.
Работать за двоих, по 10+ часов в день - нормально для меня. Это сложно, мягко говоря, но я ни дня не жалею, что делала и делаю это по сей день.
🌴 Про отдых и перезагрузку:
После нормального отдыха продуктивность кратно выше.
Поэтому к жесткому графику добавляется рутина для восстановления.
1️⃣ База
▫️ спортзал и бег (30-90 мин)
▫️ сауна + ледяные ванны (от 30мин)
▫️ прогулки (от 1 часа)
Каждый день одно и то же. Это моё спасение.
Особенно в дни, когда кажется: «я вообще ничего не успеваю».
Потому что если в такие дни не восстановиться, потом можно просто лечь лицом в ноутбук 😂
🧘♀️ Медитации
Не всегда стабильно, но когда делаю — прям чувствую, как нервная система немного возвращается на орбиту.
🎾 Теннис и падел
Во время учебы были только по выходным. Пока перерыв, пару месяцев могу позволить себе играть в течение недели!
Но! Месяц назад я подвернула ногу во время падела, что почти неделю не могла ходить.
До сих пор хромаю, играть и бегать не могу ☹️
Так что только силовые пока...
🌊 Прогулки у океана
Живу в 10 минутах на машине от берега, но выбираюсь туда не так часто, как хотелось бы.
🍇 Мероприятия
Нашла клуб, который стал лучшей инвестицией в моей жизни. Это, кстати, мой теннисный клуб.
Ужины, дегустация вина, бранчи, падел в формате "sip & serve" ("пей & подавай"), где мне и без sip сложно...
Это то, что я искала всю жизнь: атмосферу и окружение.
👥 Люди
Я часто оказываюсь рядом с теми, на кого смотришь и думаешь:
блин, ну реально же всё возможно.
все дороги открыты.
выбирай и иди.
Это очень заряжает на 10-часовые рабочие дни))
Как говорится "окажись в компании 3-х миллионеров и станешь 4-ым". Другого пути не выбираю.
✈️ Путешествия
Я живу в путешествии 😃
Вроде как даже часто летаю или езжу куда-то, так как по работе/учебе бывает надо. Но это скорее утомляет, чем перезаряжает. Люблю дом!
Такие вот мои секреты work&life баланса.
А вы как перезагружаетесь?
Делитесь в комментариях 🩷👇
P.S. Начинаю канал не про ИТ, где делюсь своей жизнью. Делиться ссылкой? Собираю 100+ 🦄
В чате был вопрос:
«А как вы отдыхаете и перезагружаетесь?»
Начну с факта о себе: отдыхать мне пришлось учиться.
И не один раз 😅
Я работаю с 14 лет. И у меня долго была установка:
👉 если не выложилась на 200%, значит плохо поработала.
Работать за двоих, по 10+ часов в день - нормально для меня. Это сложно, мягко говоря, но я ни дня не жалею, что делала и делаю это по сей день.
После нормального отдыха продуктивность кратно выше.
Поэтому к жесткому графику добавляется рутина для восстановления.
1️⃣ База
▫️ спортзал и бег (30-90 мин)
▫️ сауна + ледяные ванны (от 30мин)
▫️ прогулки (от 1 часа)
Каждый день одно и то же. Это моё спасение.
Особенно в дни, когда кажется: «я вообще ничего не успеваю».
Потому что если в такие дни не восстановиться, потом можно просто лечь лицом в ноутбук 😂
🧘♀️ Медитации
Не всегда стабильно, но когда делаю — прям чувствую, как нервная система немного возвращается на орбиту.
🎾 Теннис и падел
Во время учебы были только по выходным. Пока перерыв, пару месяцев могу позволить себе играть в течение недели!
Но! Месяц назад я подвернула ногу во время падела, что почти неделю не могла ходить.
До сих пор хромаю, играть и бегать не могу ☹️
Так что только силовые пока...
🌊 Прогулки у океана
Живу в 10 минутах на машине от берега, но выбираюсь туда не так часто, как хотелось бы.
🍇 Мероприятия
Нашла клуб, который стал лучшей инвестицией в моей жизни. Это, кстати, мой теннисный клуб.
Ужины, дегустация вина, бранчи, падел в формате "sip & serve" ("пей & подавай"), где мне и без sip сложно...
Это то, что я искала всю жизнь: атмосферу и окружение.
👥 Люди
Я часто оказываюсь рядом с теми, на кого смотришь и думаешь:
блин, ну реально же всё возможно.
все дороги открыты.
выбирай и иди.
Это очень заряжает на 10-часовые рабочие дни))
Как говорится "окажись в компании 3-х миллионеров и станешь 4-ым". Другого пути не выбираю.
✈️ Путешествия
Я живу в путешествии 😃
Вроде как даже часто летаю или езжу куда-то, так как по работе/учебе бывает надо. Но это скорее утомляет, чем перезаряжает. Люблю дом!
Такие вот мои секреты work&life баланса.
А вы как перезагружаетесь?
Делитесь в комментариях 🩷👇
P.S. Начинаю канал не про ИТ, где делюсь своей жизнью. Делиться ссылкой? Собираю 100+ 🦄
Please open Telegram to view this post
VIEW IN TELEGRAM
Please open Telegram to view this post
VIEW IN TELEGRAM
2🦄52🔥30❤13🥰9😁6👀1