API v1 · Стабильная версия

Документация API

REST API для интеграции MeerBot в ваш продукт. OpenAI-совместимый формат. Подходит для любого языка программирования.

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

Три шага, чтобы отправить первый запрос:

1Зарегистрируйтесь и создайте бота в личном кабинете
2Получите API-ключ в разделе «API-ключи»
3Отправьте запрос:

bash

curl -X POST https://meerbot.ru/api/v1/chat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assistantId": 1,
    "message": "Привет! Как вы работаете?"
  }'

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

Все запросы к API требуют Bearer-токен в заголовке Authorization.

http

Authorization: Bearer YOUR_API_KEY

⚠️ Никогда не публикуйте API-ключ в клиентском коде. Все запросы к API должны идти через ваш бэкенд.

Chat

Отправка сообщений вашему ассистенту. Поддерживает сессии для многоходовых диалогов.

POST/api/v1/chat

Отправить сообщение и получить ответ ассистента.

Тело запроса

Поле	Тип	Описание
assistantId	number	ID ассистента. Обязательный.
message	string	Текст сообщения. Обязательный.
sessionId	string	ID сессии для продолжения диалога. Опциональный.

bash

curl -X POST https://meerbot.ru/api/v1/chat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assistantId": 1,
    "message": "Какой у вас режим работы?",
    "sessionId": "user-123"
  }'

Ответ

json

{
  "id": "chatcmpl-abc123",
  "content": "Мы работаем с 9:00 до 21:00 по московскому времени.",
  "tokensUsed": 42,
  "sessionId": "user-123",
  "model": "gpt-4o-mini"
}

Assistants

Управление ассистентами. Каждый ассистент — это ваш бот с настроенной инструкцией и базой знаний.

GET/api/v1/assistants

Список всех ваших ассистентов.

bash

curl https://meerbot.ru/api/v1/assistants \
  -H "Authorization: Bearer YOUR_API_KEY"

GET/api/v1/assistants/:id

Информация о конкретном ассистенте.

bash

curl https://meerbot.ru/api/v1/assistants/1 \
  -H "Authorization: Bearer YOUR_API_KEY"

Knowledge

Загрузка базы знаний для ассистента. Поддерживаются текст, PDF, DOCX, TXT и URL.

POST/api/v1/knowledge

Загрузить файл или текст в базу знаний ассистента.

bash

# Загрузка текста
curl -X POST https://meerbot.ru/api/v1/knowledge \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assistantId": 1,
    "type": "text",
    "content": "Наш магазин работает с 9:00 до 21:00."
  }'

# Загрузка файла
curl -X POST https://meerbot.ru/api/v1/knowledge \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "assistantId=1" \
  -F "file=@faq.pdf"

Ошибки

API использует стандартные HTTP-коды. Тело ошибки всегда содержит поле error.

Код	Значение
400	Неверный запрос — проверьте параметры
401	Не авторизован — неверный или отсутствующий API-ключ
404	Ресурс не найден
429	Превышен лимит запросов
500	Внутренняя ошибка сервера

Лимиты

Лимиты зависят от вашего тарифного плана. Текущие лимиты доступны в разделе тарифов.

Запросов в минуту

4 000 симв.

Макс. длина сообщения

10 MB

Макс. размер файла

SDK и примеры

MeerBot API совместим с OpenAI SDK. Используйте любой удобный инструмент.

Node.js

javascript

const response = await fetch('https://meerbot.ru/api/v1/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    assistantId: 1,
    message: 'Привет!',
    sessionId: 'user-123',
  }),
})

const { content } = await response.json()
console.log(content)

Python

python

import requests

response = requests.post(
    'https://meerbot.ru/api/v1/chat',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
        'assistantId': 1,
        'message': 'Привет!',
        'sessionId': 'user-123',
    }
)

print(response.json()['content'])

Нужна помощь с интеграцией?

Напишите нам — поможем подключить API к вашему проекту.

Написать в Telegram