URL de base
https://app.kwamlemedia.com/api/v1
Authentification
Chaque requête nécessite un Bearer Token dans l'en-tête :
Authorization: Bearer YOUR_API_TOKEN
Obtenez votre token dans Paramètres → Clés API.
Bots
GET
/botsListe tous vos bots.
GET
/bots/{id}Détails d'un bot spécifique.
POST
/botsCrée un nouveau bot.
PATCH
/bots/{id}Met à jour les données d'un bot.
DELETE
/bots/{id}Supprime un bot.
Abonnés
GET
/subscribersListe les abonnés avec pagination.
GET
/subscribers/{id}Données d'un abonné spécifique.
POST
/subscribers/{id}/messagesEnvoie un message à un abonné spécifique.
POST
/subscribers/{id}/tagsAjoute un tag à un abonné.
Publications
GET
/postsListe les publications programmées et publiées.
POST
/postsCrée/programme une nouvelle publication.
E-commerce
GET
/productsListe les produits.
POST
/productsAjoute un nouveau produit.
GET
/ordersListe les commandes.
AI Studio
POST
/ai/chatAppel IA multi-fournisseur avec sélection automatique.
GET
/ai/usageStatistiques de consommation quotidienne de tokens.
Exemple de requête
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
Abonnez-vous aux événements en direct de la plateforme (nouveau message, nouvelle commande, nouveau commentaire) :
POST /webhooks
{
"url": "https://yourdomain.com/webhook",
"events": ["message.received", "order.created", "comment.posted"]
}
Limitation du débit
- Free : 60 requêtes/min
- Pro : 600 requêtes/min
- Enterprise : 6 000 requêtes/min + personnalisé
Les en-têtes X-RateLimit-Remaining et X-RateLimit-Reset renvoient des informations en temps réel.
SDK officiels en développement
Bientôt disponibles : bibliothèques pour Node.js, Python, PHP et Go.
Pour les questions techniques : api@kwamlemedia.com
