База знаний GetMyBot

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

Первый запрос к GetMyBot API за пять минут: создать персональный токен и вызвать REST.

На этой странице

Чтобы выполнить первый запрос, создайте персональный токен, узнайте базовый адрес и вызовите 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».

Первый запрос Managed AI

Создайте PAT со scope managed_ai:invoke. Один и тот же ключ используйте только при повторе того же запроса:

curl -X POST https://ваш-домен/api/v1/ai/responses \
  -H "Authorization: Bearer mbp_ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ai-demo-0001" \
  -d '{"profile":"balanced","provider":"auto","input":[{"role":"user","content":[{"type":"input_text","text":"Сделай краткое резюме диалога"}]}],"max_output_tokens":300}'

Перед показом Managed AI или Meta UI проверяйте /api/public/capabilities. Недоступность feature является состоянием продукта, а не сетевой ошибкой.

Что дальше