☕️ Про API

Пост для тех, кто слышит слова "API", "эндпоинт", "REST", но до конца не понимает, как это работает и зачем нужно.

Это как меню в ресторане: вы выбираете блюдо (request/запрос), официант (API) передаёт заказ на кухню (сервер) и приносит результат (response). Вам не нужно знать, как готовят — достаточно указать, что хотите.

Выше, в карточках, можно узнать подробнее как это устроено, а ниже основные термины:

🧩 Resource (ресурс) — объект, с которым работает API (например, пользователь, заказ). Каждый ресурс имеет свой URL (адрес), например, /users/123.

🚪 Endpoint (Эндпоинт) — адрес, по которому можно обратиться к API. Как почтовый ящик, но для данных. Например: api.example.com/users — это endpoint для получения списка пользователей.

📬 HTTP Methods (Методы запросов) — глаголы, которые говорят API, что вы хотите сделать: GET — запросить данные (как прочитать письмо); POST — отправить новые данные (как отправить письмо); PUT/PATCH — изменить существующие данные; DELETE — удалить данные.

📤 Request (Запрос) — сообщение от клиента к серверу с просьбой что-то сделать. Как письмо с надписью «Хочу список пользователей».
Состоит из: метода (GET), эндпоинта (/users), заголовков и тела (если нужно).

📥 Response (Ответ) — сообщение от сервера в ответ на запрос. Как конверт, который пришёл обратно: «Вот список пользователей» или «Ошибка: доступ запрещён».
Содержит: статус-код (200, 404), заголовки и тело с данными.

📄 Body (Тело) / Payload (Полезная нагрузка) — основное содержимое запроса или ответа. Как текст письма внутри конверта.

📝 Headers (Заголовки) — служебная информация о запросе/ответе — как надписи на конверте: «Срочно», «Только для вас».
Примеры: Content-Type: application/json (тип данных), Authorization: Bearer token (ключ доступа).

🔑 API Key (Ключ API) — уникальный идентификатор, как пароль для доступа к API. Нужен, чтобы система знала, кто делает запрос.
Представьте это как пропуск на работу — без него вас не пустят.

🚦 Status Codes (Коды ответов) — Числа, объясняющие результат запроса: 200 OK — всё хорошо, 404 Not Found — не найдено, 401 Unauthorized — нет доступа.
Как светофор: зелёный — едем, красный — стоп.

#api #ликбез #simplewords

☕️ Получение данных в Excel по API

Excel — это не только таблицы и формулы. Прямо из Excel можно подключаться к API и выгружать данные как профи. Сегодня расскажу, как превратить Excel в мощный инструмент для работы с API без единой строчки кода.

🙉 Как это вообще возможно?

Excel (особенно версии для Windows) имеет встроенную функцию Power Query — мощный инструмент для подключения к различным источникам данных. И да, API — один из таких источников!

🧐 Зачем это вообще нужно?
— Анализировать данные без программирования
— Создавать отчеты на основе актуальных данных
— Сравнивать данные из разных источников
— Быстро проверять гипотезы без помощи разработчиков

📖 Разберём на примере: GitHub API

Допустим, вы хотите собрать информацию о репозиториях пользователя. Делаем так:

1. Откройте Excel, во вкладке Данные → Получить данные → Из других источников → Из веб.
2. Укажите URL GitHub API: например, для репозиториев вашего аккаунта: https://api.github.com/user/repos
3. Настройка аутентификации:
После ввода URL нажмите ОК.
Появится окно Authentication:
Выберите Basic → введите: Username: Ваш GitHub логин. Password: Скопированный токен (в поле пароля!).
Нажмите Connect.
4. После подключения откроется редактор Power Query.
Преобразование JSON в таблицу. Если данные отображаются как список или запись: Выберите Record или List → To Table.
Раскрытие вложенных полей. Для каждого столбца с данными нажмите на стрелку раскрытия рядом с названием столбца.
Сохранение и загрузка в Excel: Во вкладке Главная → Закрыть и загрузить → Закрыть и загрузить в.... Выберите, куда поместить данные (новый лист или существующий).
5. Чтобы обновлять данные без повторного подключения: Щелкните правой кнопкой по таблице в Excel → Обновить.

💡Главный подводный камень: пагинация
Большинство API ограничивают количество записей в одном запросе (обычно 10-100). Это называется пагинация.
Пример: GitHub API возвращает максимум 100 репозиториев за раз. Если их больше, нужно делать несколько запросов.
Как обойти пагинацию в Excel? Можно создать запрос, который автоматически перебирает страницы, а можно вручную менять параметры в URL и объединять результаты.

⚙️ Ограничения, о которых нужно знать
— Лимиты запросов — большинство публичных API имеют ограничения на количество запросов в минуту/час
— Авторизация — для некоторых API нужно добавлять заголовки авторизации (в Power Query это делается через "Дополнительные параметры")
— Структура данных — если API меняет структуру ответа, ваш запрос может перестать работать
— Максимальный размер — Excel имеет ограничения на количество строк (около 1 млн в современных версиях)

🤌 Лайфхак
Создайте шаблон Excel с подключением к нужному API один раз, сохраните его. Теперь вы можете обновлять данные одним кликом (Данные → Обновить все)!
Это особенно полезно для продуктовых менеджеров, аналитиков и всех, кто работает с данными, но не пишет код.

#excel #api #analytics #lifehacks

☕️ Виды аналитики

В работе сейчас есть проект, в рамках которого мы исследуем проблемы дата-аналитиков, и пытаемся подобрать нужный набор инструментов для каждой задачи. На встречах всплывает то один термин, то другой. И я понял, что нам нужен project vocabulary — общий понятийный аппарат. Иначе будет непонятно кто что делает и какую задачу мы решаем.

В результате изысканий получились такие таблички (см. скрины).

Если коротко:
— Self-Service Analytics — umbrella-категория, объединяющая процессы, доступные бизнес-пользователям (от Data Discovery до Reporting).
— Data Discovery и Data Exploration тесно связаны: первое включает поиск данных и их подготовку, второе — анализ.
— Ad-hoc — не самостоятельный процесс, а тип аналитики, характеризующийся разовостью. Результаты такой деятельности, как правило, более нигде не применимы, кроме как для задачи, для которой они решались.
— Data Mining требует глубокой подготовки данных (Data Preparation) и построения моделей (Data Modeling).

#analytics #terms

☕️ Как составить опрос, на который люди захотят ответить (и не наврут)

Вы когда-нибудь получали опросы, которые хочется закрыть с первого взгляда? Длинные, запутанные, с вопросами в духе "Оцените наш сервис по шкале от 1 до 10, где 1 — это когда вы просыпаетесь от кошмара, а 10 — когда находите потерянный кошелек"?

Сегодня разберём, как сделать опросы, которые:
— Люди будут заполнять с удовольствием
— Дадут вам реальные данные, а не "как надо"
— Помогут принять правильные решения

(см. карточки ↑ 😉)

Хороший опрос — это когда вы получаете не просто данные, а понимание причин поведения пользователей.

P.S. Рекомендую ещё заглянуть в этот классный гайд, к которому я часто возвращаюсь при проведении очередного опроса)

#analytics #research #product #poll