Новинка: Kwamle AI Studio уже доступен — создавайте умных чат-ботов за минуты.Узнать больше →
Ресурсы

REST API.

Современный REST API для всего в Kwamle Media — боты, подписчики, публикации, магазины и ИИ.

REST API.

Базовый URL

https://app.kwamlemedia.com/api/v1

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

Каждый запрос требует Bearer Token в заголовке:

Authorization: Bearer YOUR_API_TOKEN

Получите токен в разделе Настройки → API-ключи.

Боты

GET/bots
Список всех ваших ботов.
GET/bots/{id}
Сведения о конкретном боте.
POST/bots
Создать нового бота.
PATCH/bots/{id}
Обновить данные бота.
DELETE/bots/{id}
Удалить бота.

Подписчики

GET/subscribers
Список подписчиков с разбивкой на страницы.
GET/subscribers/{id}
Данные конкретного подписчика.
POST/subscribers/{id}/messages
Отправить сообщение конкретному подписчику.
POST/subscribers/{id}/tags
Добавить тег подписчику.

Публикации

GET/posts
Список запланированных и опубликованных публикаций.
POST/posts
Создать/запланировать новую публикацию.

Электронная коммерция

GET/products
Список товаров.
POST/products
Добавить новый товар.
GET/orders
Список заказов.

AI Studio

POST/ai/chat
Мультипровайдерный вызов ИИ с автоматическим выбором.
GET/ai/usage
Статистика ежедневного расхода токенов.

Пример запроса

curl -X POST https://app.kwamlemedia.com/api/v1/ai/chat \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "user", "content": "Write me an ad for a new product"}
    ],
    "max_tokens": 500
  }'

Вебхуки

Подпишитесь на события платформы в реальном времени (новое сообщение, новый заказ, новый комментарий):

POST /webhooks
{
  "url": "https://yourdomain.com/webhook",
  "events": ["message.received", "order.created", "comment.posted"]
}

Ограничение частоты запросов

  • Free: 60 запросов/мин
  • Pro: 600 запросов/мин
  • Enterprise: 6 000 запросов/мин + индивидуально

Заголовки X-RateLimit-Remaining и X-RateLimit-Reset возвращают информацию в реальном времени.

Официальные SDK в разработке

Скоро: библиотеки для Node.js, Python, PHP и Go.
По техническим вопросам: api@kwamlemedia.com