Novità: Kwamle AI Studio è ora disponibile — crea chatbot intelligenti in pochi minuti.Scopri →
Risorse

REST API.

Un'API REST moderna per tutto in Kwamle Media — bot, iscritti, post, negozi e IA.

REST API.

URL di base

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

Autenticazione

Ogni richiesta richiede un Bearer Token nell'header:

Authorization: Bearer YOUR_API_TOKEN

Ottieni il tuo token da Impostazioni → Chiavi API.

Bot

GET/bots
Elenca tutti i tuoi bot.
GET/bots/{id}
Dettagli di un bot specifico.
POST/bots
Crea un nuovo bot.
PATCH/bots/{id}
Aggiorna i dati di un bot.
DELETE/bots/{id}
Elimina un bot.

Iscritti

GET/subscribers
Elenca gli iscritti con paginazione.
GET/subscribers/{id}
Dati di un iscritto specifico.
POST/subscribers/{id}/messages
Invia un messaggio a un iscritto specifico.
POST/subscribers/{id}/tags
Aggiunge un tag a un iscritto.

Post

GET/posts
Elenca i post programmati e pubblicati.
POST/posts
Crea/programma un nuovo post.

Ecommerce

GET/products
Elenca i prodotti.
POST/products
Aggiunge un nuovo prodotto.
GET/orders
Elenca gli ordini.

AI Studio

POST/ai/chat
Chiamata IA multi-provider con selezione automatica.
GET/ai/usage
Statistiche sul consumo giornaliero di token.

Richiesta di esempio

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

Webhook

Iscriviti agli eventi in tempo reale della piattaforma (nuovo messaggio, nuovo ordine, nuovo commento):

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

Limite di frequenza

  • Free: 60 richieste/min
  • Pro: 600 richieste/min
  • Enterprise: 6.000 richieste/min + personalizzato

Gli header X-RateLimit-Remaining e X-RateLimit-Reset restituiscono informazioni in tempo reale.

SDK ufficiali in sviluppo

In arrivo: librerie per Node.js, Python, PHP e Go.
Per domande tecniche: api@kwamlemedia.com