Mới: Kwamle AI Studio đã ra mắt — tạo chatbot thông minh chỉ trong vài phút.Khám phá →
Tài nguyên

REST API.

Một REST API hiện đại cho mọi thứ trong Kwamle Media — bot, người đăng ký, bài đăng, cửa hàng và AI.

REST API.

URL cơ sở

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

Xác thực

Mỗi yêu cầu cần một Bearer Token trong header:

Authorization: Bearer YOUR_API_TOKEN

Lấy token của bạn từ Cài đặt → Khóa API.

Bot

GET/bots
Liệt kê tất cả bot của bạn.
GET/bots/{id}
Chi tiết của một bot cụ thể.
POST/bots
Tạo một bot mới.
PATCH/bots/{id}
Cập nhật dữ liệu của một bot.
DELETE/bots/{id}
Xóa một bot.

Người đăng ký

GET/subscribers
Liệt kê người đăng ký kèm phân trang.
GET/subscribers/{id}
Dữ liệu của một người đăng ký cụ thể.
POST/subscribers/{id}/messages
Gửi tin nhắn đến một người đăng ký cụ thể.
POST/subscribers/{id}/tags
Thêm thẻ cho một người đăng ký.

Bài đăng

GET/posts
Liệt kê bài đăng đã lên lịch và đã đăng.
POST/posts
Tạo/lên lịch một bài đăng mới.

Thương mại điện tử

GET/products
Liệt kê sản phẩm.
POST/products
Thêm một sản phẩm mới.
GET/orders
Liệt kê đơn hàng.

AI Studio

POST/ai/chat
Lệnh gọi AI đa nhà cung cấp với lựa chọn tự động.
GET/ai/usage
Thống kê mức tiêu thụ token hằng ngày.

Yêu cầu ví dụ

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

Đăng ký các sự kiện trực tiếp của nền tảng (tin nhắn mới, đơn hàng mới, bình luận mới):

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

Giới hạn tốc độ

  • Free: 60 yêu cầu/phút
  • Pro: 600 yêu cầu/phút
  • Enterprise: 6.000 yêu cầu/phút + tùy chỉnh

Các header X-RateLimit-Remaining và X-RateLimit-Reset trả về thông tin theo thời gian thực.

SDK chính thức đang phát triển

Sắp ra mắt: thư viện cho Node.js, Python, PHP và Go.
Câu hỏi kỹ thuật: api@kwamlemedia.com