Novedad: Kwamle AI Studio ya está disponible — crea chatbots inteligentes en minutos.Descubrir →
Recursos

REST API.

Una API REST moderna para todo en Kwamle Media — bots, suscriptores, publicaciones, tiendas e IA.

REST API.

URL base

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

Autenticación

Cada solicitud requiere un Bearer Token en la cabecera:

Authorization: Bearer YOUR_API_TOKEN

Obtén tu token en Configuración → Claves API.

Bots

GET/bots
Lista todos tus bots.
GET/bots/{id}
Detalles de un bot específico.
POST/bots
Crea un nuevo bot.
PATCH/bots/{id}
Actualiza los datos de un bot.
DELETE/bots/{id}
Elimina un bot.

Suscriptores

GET/subscribers
Lista los suscriptores con paginación.
GET/subscribers/{id}
Datos de un suscriptor específico.
POST/subscribers/{id}/messages
Envía un mensaje a un suscriptor específico.
POST/subscribers/{id}/tags
Añade una etiqueta a un suscriptor.

Publicaciones

GET/posts
Lista las publicaciones programadas y publicadas.
POST/posts
Crea/programa una nueva publicación.

Ecommerce

GET/products
Lista los productos.
POST/products
Añade un nuevo producto.
GET/orders
Lista los pedidos.

AI Studio

POST/ai/chat
Llamada de IA multiproveedor con selección automática.
GET/ai/usage
Estadísticas de consumo diario de tokens.

Solicitud de ejemplo

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
  }'

Webhooks

Suscríbete a eventos en vivo de la plataforma (nuevo mensaje, nuevo pedido, nuevo comentario):

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

Límite de tasa

  • Free: 60 solicitudes/min
  • Pro: 600 solicitudes/min
  • Enterprise: 6.000 solicitudes/min + personalizado

Las cabeceras X-RateLimit-Remaining y X-RateLimit-Reset devuelven información en tiempo real.

SDK oficiales en desarrollo

Próximamente: bibliotecas para Node.js, Python, PHP y Go.
Para preguntas técnicas: api@kwamlemedia.com