База знаний GetMyBot

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

Как программе получить список ваших ботов и создать реакцию. Первый запрос, токен доступа и примеры curl.

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

API позволяет вашей программе выполнять действия в GetMyBot: читать список ботов, создавать реакции или получать данные. Этот пример предназначен для разработчика интеграции. Для обычной настройки бота используйте визуальный конструктор.

Сначала создайте ключ доступа, персональный токен. Затем отправьте HTTP-запрос на адрес операции, эндпоинт. Ниже используются команды curl, которые выполняются в терминале. Адрес https://ваш-домен замените адресом вашей установки GetMyBot.

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

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

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

Все REST-эндпоинты живут под префиксом /api. Версионирования в пути нет. Тела запросов и ответов: JSON; передавайте заголовок Content-Type: application/json для запросов с телом. Токен передаётся заголовком Authorization: Bearer <ПЕРСОНАЛЬНЫЙ_ТОКЕН>: вместо <ПЕРСОНАЛЬНЫЙ_ТОКЕН> (вместе с угловыми скобками) вставьте токен целиком, вместе с префиксом mbp_. Отдельно префикс добавлять не нужно.

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

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

curl -H "Authorization: Bearer <ПЕРСОНАЛЬНЫЙ_ТОКЕН>" https://ваш-домен/api/bots

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

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

Мутация означает запрос, который меняет данные. В этом примере он создаст новую реакцию у выбранного бота. Выполняйте его на проекте, где такая реакция нужна.

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

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

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

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

Когда токен работает, остальные операции смотрите в интерактивном справочнике: там есть список адресов API, требуемые области доступа, поля запросов и кнопка Try it для пробного вызова.

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

Создайте PAT с областью доступа managed_ai:invoke. Значение Idempotency-Key отличает одну операцию от другой: при повторе того же запроса оставьте ключ и тело прежними, для новой операции возьмите новый ключ.

curl -X POST https://ваш-домен/api/v1/ai/responses \
  -H "Authorization: Bearer <ПЕРСОНАЛЬНЫЙ_ТОКЕН>" \
  -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, сначала запросите /api/public/capabilities. Ответ сообщает, включена ли функция на этой установке. Выключенная функция не означает сбой сети: скройте её или покажите состояние недоступности.

Что дальше