Νέο: Το Kwamle AI Studio είναι πλέον διαθέσιμο — δημιουργήστε έξυπνα chatbots σε λεπτά.Ανακαλύψτε →
Πόροι

REST API.

Ένα σύγχρονο REST API για τα πάντα στο Kwamle Media — bots, συνδρομητές, δημοσιεύσεις, καταστήματα και AI.

REST API.

Βασικό URL

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

Έλεγχος ταυτότητας

Κάθε αίτημα απαιτεί ένα Bearer Token στην κεφαλίδα:

Authorization: Bearer YOUR_API_TOKEN

Λάβετε το token σας από τις Ρυθμίσεις → Κλειδιά API.

Bots

GET/bots
Παραθέτει όλα τα bots σας.
GET/bots/{id}
Λεπτομέρειες ενός συγκεκριμένου bot.
POST/bots
Δημιουργεί ένα νέο bot.
PATCH/bots/{id}
Ενημερώνει τα δεδομένα ενός bot.
DELETE/bots/{id}
Διαγράφει ένα bot.

Συνδρομητές

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
Κλήση AI πολλαπλών παρόχων με αυτόματη επιλογή.
GET/ai/usage
Στατιστικά ημερήσιας κατανάλωσης token.

Παράδειγμα αιτήματος

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

Εγγραφείτε σε ζωντανά συμβάντα της πλατφόρμας (νέο μήνυμα, νέα παραγγελία, νέο σχόλιο):

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