Быстрый старт 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. Ответ сообщает, включена ли функция на этой установке. Выключенная функция не означает сбой сети: скройте её или покажите состояние недоступности.
Что дальше
- Авторизация и токены: про PAT, заголовок и области доступа.
- Ошибки: формат и коды состояний.
- Пагинация: как листать большие списки.