Быстрый старт API

Этот гайд проведёт от нуля до первого успешного запроса: создать персональный токен, узнать базовый адрес и вызвать REST-эндпоинт.

Шаг 1. Создать персональный токен

Откройте личный кабинет, раздел персональных токенов, и создайте новый токен (PAT). Скопируйте его значение сразу — оно показывается один раз и начинается с префикса mbp_. При создании выберите области доступа (scopes), достаточные для вашей задачи; подробнее в гайде по авторизации.

Шаг 2. Базовый адрес и формат

Все REST-эндпоинты живут под префиксом /api. Версионирования в пути нет. Тела запросов и ответов — JSON; передавайте заголовок Content-Type: application/json для запросов с телом. Токен передаётся заголовком Authorization: Bearer mbp_….

Шаг 3. Первый запрос — список ботов

Проверьте токен запросом списка ваших ботов. Для этого нужен scope bots:read (или *):

curl -H "Authorization: Bearer mbp_ВАШ_ТОКЕН" https://ваш-домен/api/bots

В ответ придёт JSON-массив ботов. Если токен неверный или просрочен — вернётся 401 с телом {"error":"..."} (см. ошибки).

Шаг 4. Первая мутация — создать реакцию

Создание реакции требует scope reactions:write. Подставьте идентификатор бота из шага 3:

curl -X POST -H "Authorization: Bearer mbp_ВАШ_ТОКЕН" -H "Content-Type: application/json" -d '{"name":"Привет","trigger":{"type":"command","value":"/start"}}' https://ваш-домен/api/bots/BOT_ID/reactions

Успешный ответ вернёт созданную реакцию с её id. Точные поля тела смотрите в интерактивном справочнике — он генерирует готовые примеры на curl, JavaScript и Python для каждого эндпоинта.

Шаг 5. Дальше — по справочнику

Когда токен работает, остальное удобнее изучать в интерактивном справочнике: там виден полный список эндпоинтов, требуемые scopes, схемы тел и кнопка «Try it».

Что дальше