Аутентификация API

Каждому запросу нужен API-токен (Personal Access Token) в заголовке Authorization. Токен действует от вашего имени: видит ваши проекты и аналитику и может всё, что можете вы в кабинете, кроме управления токенами.

Создать токен

1. Откройте кабинет: API-токены.
2. Нажмите Создать токен и дайте ему понятное название («Скрипт отчётов», «Zapier»).
3. Скопируйте токен. Он начинается с wmp_ и показывается только один раз — Warmup хранит лишь его хэш.

Использовать

curl https://api.warmup.social/projects \
  -H "Authorization: Bearer wmp_ВАШ_ТОКЕН"

const res = await fetch("https://api.warmup.social/projects", {
  headers: { Authorization: `Bearer ${process.env.WARMUP_TOKEN}` },
});
const { projects } = await res.json();

В списке токенов в кабинете видно, когда каждый из них использовался последний раз.

Отозвать токен

Нажмите Отозвать рядом с токеном в кабинете. Запросы с отозванным токеном сразу получают 401.

Осторожно

Обращайтесь с токеном как с паролем: храните его в переменных окружения или менеджере секретов, никогда — в клиентском коде или репозитории. Заводите отдельный токен на каждую интеграцию, чтобы отозвать один, не ломая остальные.

Ошибки

Статус	Что значит
401	Нет заголовка, токен неверный, отозван или истёк.
403	Действие недоступно с API-токеном (например, создание токенов).