📚 Что почитать и посмотреть по REST API: подборка материалов от GetAnalyst 📚

У нас много новых участников в сообществе 🙌 И…!
Вместо того, чтобы рассказывать о себе, сделала для вас самую полную и актуальную подборку полезных материалов по проектированию REST API.

Так вы лучше узнаете меня - Екатерину Ананьеву - не на словах, а в деле 🙂

Материалы расположены по порядку - от простого к сложному.
Они помогут вам сделать крутой прорыв в освоении темы и разобраться в сложных вопросах.

(С) Структура метода REST API

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

(С) Методы HTTP (REST) и их назначение

(C) Как строить URL в REST API

(C) Всё про JSON в одной картинке

(С) Мини-книга про JSON

(В) Связь БД и дизайна REST API

(С) Headers

(С) 6 способов пагинации

(С) Проектирование ошибок в REST API

(В) Проект “Система для автосервиса” - видео-обучение:
1. Сбор бизнес-требований, погружение в контекст
2. Определение сущностей и проектирование логической модели БД
3. REST API с нуля: дизайн методов для работы менеджера с заявками автосервиса

(С) 6 ключевых принципов REST API - теория, но спрашивают понимание

(C) Postman: Практическое руководство с примером тестирования открытого API DaData

(С) Postman: Практическое руководство с примером - API DaData - ещё один сервис

(C) Postman: Практическое руководство с примером - платежная система ВТБ

(П) Вопросы и ответы по REST API: собеседование на СА

(В) Собеседование на СА: разбор задачи на асинхронные запросы в REST API

(C) Шаблон постановки задачи на REST API метод

(П) gRPС vs REST - что выбрать для проекта

(C) Проектирование REST API: спорные вопросы с проектов и собеседований на системного аналитика (и не только)

(С) Исследование реальных REST API на соответствие REST: Trello, Todoist

Также вы можете найти у нас мини-обучения и продвинутую практическую программу Дизайн REST API для опытных аналитиков.

(В) Видео
(П) Подкасты
(С) Статьи


Делитесь с коллегами, особенно с джунами и мидлами СА!

Сохранили? ❤️

#RestApiGA

🔐 Авторизация и аутентификация в REST API: что, зачем и как 🔐

▫️ Аутентификация (Authentication) — подтверждение, что это действительно тот клиент / пользователь, за кого он себя выдаёт.

Проверяется при входе в систему, когда пользователь предоставляет ключи доступа:
+ логин+пароль
+ токен

Если аутентификация не пройдена, то API должен вернуть ошибку HTTP-401.



▫️ Авторизация (Authorization) — проверка прав аутентифицированного клиента: что ему можно, а что нет.

При выполнении очередного действия в системе, например - удаление мероприятия в календаре, надо проверить, что у него есть права на это (он его создал, оно в его календаре).

Если нет прав, то API должен вернуть ошибку HTTP-403.




▫️ Основные схемы аутентификации

🔑 API-ключи
• Простая пара «ключ=значение» в заголовке X-API-Key.
• Быстро настраивается, но статичен и часто уязвим (нет ротации, нет TTL).

Пример Header:

X-API-Key: 123e4567-e89b-12d3-a456-426614174000

🔒 HTTP Basic Auth
• Передаёт логин/пароль закодированным в Base64 в заголовке Authorization: Basic <credentials>.
• Использовать только по HTTPS.

Пример Header:

Authorization: Basic bXlVc2VyOm15UGFzc3dvcmQ=

🚀 JWT (JSON Web Token)
• Короткоживущий токен с подписанным payload’ом (claims).
• Передача в заголовке Authorization: Bearer <token>.
• Удобен для распределённых систем: нет обращений к БД при каждом запросе.


🌐 OAuth 2.0
• Полноценный фреймворк (стандарт) для выдачи и обновления токенов: Access + Refresh Token.
• Подходит для публичных API и сторонних интеграций.
• Поддерживает разные гранты (Client Credentials, Authorization Code и другие).




▫️ В описании API-метода обязательно указать:
+ какую схему аутентификации поддерживаем
+ формат токена (JWT, UUID и т.д.)
+ куда передавать (заголовок, query-параметр, cookie)
+ список возможных ошибок и их тело (JSON-ответ)

Нужно глубже погрузиться в тему аутентификации

и авторизации в API?

🎧 Подкаст и статья тут 🙂


#RestApiGA

Привет! Сегодня расскажу про свою учёбу по AI в Harvard 🎓

Начну с того, что это не только про «узнать что-то новое». Многое уже давно знакомо.

Но даже те знания, которые у меня уже были, раскрываются с совершенно другой стороны 🤩

Что особенно цепляет:
— новые реальные примеры использования AI,
— обсуждение, какие IT-продукты выживут, а какие уже «в зоне риска»,
— куда всё идёт и как готовиться.


👉 Важные моменты, которыми хочу поделиться:


📌 Инсайт 1:

Когда появились браузеры и интернет — доступ к информации стал дешевле.

Выиграли те, кто это понял раньше всех: Google, Amazon, Netflix, Яндекс, и т.д.

Теперь та же история, только с когнитивными способностями:

AI делает доступ к мышлению дешевле.

Простые задачи он уже берёт на себя. И это только начало.
ChatGPT и подобные продукты — аналог браузера.
А что дальше?

Пока мы только на пороге зарождения AI-компаний, и настоящих передовых AI-продуктов пока нет.


📌 Инсайт 2:

Те, кто умеют использовать ИИ — будут на шаг впереди.

Не потому что «AI всех заменит», а потому что с ним можно делать больше, быстрее и точнее. Он повышает продуктивность.
На это уже смотрят при найме в ведущих IT-компаниях.


📌 Инсайт 3:

Был отдельный раздел про галлюцинации AI.
Важная мысль:

ChatGPT — не поисковик.

Он создан не для «найти ответ», а для «придумать что-то новое».
Это Generative AI (генеративный икусственный интеллект). От слова генерировать = создавать. Но не искать 😅

Жалобы «какую-то ерунду ответил, опять не то, опять придумал» — это просто недопонимание того, как работает генеративный AI.

Он не ищет, он генерирует.
Поэтому и ответы у нас с вами разные.

Тем не менее.... 😄
Это самый популярный Use Case. И под поиск ChatGPT добавил отдельный режим. Если пользуетесь им как поисковиком - включать его.



👉 Я работаю над проектом по внедрению AI в образование.

Учёба идёт интенсивно, времени уходит много — но это именно тот путь, который мне интересен.

Каждый день ощущаю, что становлюсь сильнее как специалист (= лучшей версией себя).

Радуюсь новым шагам 🙌