Τεκμηρίωση API για developers

Πρώτα βήματα

Κάθε επί πληρωμή πακέτο περιλαμβάνει πλήρη πρόσβαση στο REST API. Δημιουργήστε ένα κλειδί στον λογαριασμό σας, στην ενότητα Λογαριασμός → Κλειδιά API, και στείλτε το με κάθε αίτημα:

curl -H "X-Api-Key: YOUR_KEY" https://mailflow.top/api/index.php/lists

Βασικό URL: https://mailflow.top/api/index.php · Οι απαντήσεις είναι σε JSON με πεδίο status με τιμή success ή error. Το API δεν είναι διαθέσιμο στο δωρεάν πακέτο.

Βασικοί πόροι

Η πλατφόρμα είναι συμβατή με το MailWizz, οπότε ολόκληρο το βασικό API — λίστες, συνδρομητές, τμήματα, προσαρμοσμένα πεδία, καμπάνιες, παρακολούθηση, πρότυπα, email συναλλαγών, επιστροφές, απεγγραφές — τεκμηριώνεται διαδραστικά (OpenAPI) στη διεύθυνση:

→ Διαδραστική τεκμηρίωση αναφοράς API (OpenAPI)

Τα υπάρχοντα SDK του MailWizz (π.χ. το επίσημο PHP SDK) λειτουργούν αμέσως — απλώς ορίστε σε αυτά το παραπάνω βασικό URL.

Endpoints AI

Οι λειτουργίες AI είναι πλήρως ενσωματωμένες στο API. Ίδιο κλειδί, ίδιος έλεγχος ταυτότητας, ίδια όρια πακέτου και ίδια μέτρηση μονάδων με την εφαρμογή web.

GET /ai/credits

Ο μετρητής μονάδων AI για τον τρέχοντα μήνα. Οι μονάδες ισχύουν ανά μήνα χρέωσης και οι αχρησιμοποίητες δεν μεταφέρονται.

{"status":"success","data":{"unlimited":false,"limit":750,"used":112,"remaining":638}}

GET /ai/replies

Ταξινομήσεις Smart Replies για τις καμπάνιες σας — τροφοδοτήστε το CRM σας με το ποιος ενδιαφέρεται, ποιος έκανε ερώτηση, ποιος παραπονέθηκε. Φίλτρα: category (interested, question, complaint, unsubscribe_request, auto_reply, out_of_office, bounce, other), campaign_uid, since (YYYY-MM-DD), page, per_page (έως 50).

curl -H "X-Api-Key: YOUR_KEY" \
  "https://mailflow.top/api/index.php/ai/replies?category=interested&since=2026-08-01"

{"status":"success","data":{"count":42,"current_page":1,"per_page":20,"total_pages":3,
  "records":[{"from_email":"[email protected]","subject":"RE: your offer",
    "category":"interested","confidence":98,"engine":"embeddings",
    "summary":"...","suggested_reply":"...","date_added":"2026-08-24 18:21:19",
    "campaign_uid":"py794hjqk8a8d"}]}}

GET /ai/tiers

Επίπεδα αλληλεπίδρασης AI (vip, engaged, passive, at_risk, dormant) ανά λίστα — η ίδια βαθμολόγηση που τροφοδοτεί τον αυτόματο πιλότο και την επαναφορά.

{"status":"success","data":{"records":[
  {"list_uid":"qk661oq7nl8c1","name":"Main list","tiers":{"engaged":1200,"passive":3400,"dormant":900}}]}}

POST /ai/subject-lines

Δημιουργήστε θέματα σε οποιαδήποτε γλώσσα. Σώμα: topic (υποχρεωτικό), count (1–5, προεπιλογή 3), language (προαιρετικό). Καταναλώνει μονάδες AI όπως ο επεξεργαστής web.

curl -X POST -H "X-Api-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"topic":"Summer sale for B2B customers","count":3,"language":"Greek"}' \
  https://mailflow.top/api/index.php/ai/subject-lines

{"status":"success","data":{"subjects":["...","...","..."],"credits_remaining":636}}

GET /ai/flows · POST /ai/flows/author · POST /ai/flows/<uid>/enroll · POST /ai/flows/<uid>/status

Δημιουργία ροών με AI μέσω του API: εμφανίστε τις ροές σας με μετρητές σε πραγματικό χρόνο· αναθέστε στην AI να συντάξει μια ολοκληρωμένη ροή από έναν στόχο διατυπωμένο σε απλή γλώσσα ({"goal":"...","list_uid":"..."} — επιστρέφει ένα προσχέδιο που ενεργοποιείτε με {"status":"active"})· προσθέστε έναν συνδρομητή σε μια ροή ({"email":"..."}).

curl -X POST -H "X-Api-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"goal":"When someone replies interested, notify me, wait 2 days, then send a case study"}' \
  https://mailflow.top/api/index.php/ai/flows/author

Σφάλματα και όρια

401 — λείπει ή δεν είναι έγκυρο το X-Api-Key
403 — η λειτουργία δεν περιλαμβάνεται στο πακέτο σας
422 — ελλιπείς/μη έγκυρες παράμετροι
429 — εξαντλήθηκε το όριο μονάδων AI ή το μηνιαίο περιθώριο AI· ανανεώνεται στην επόμενη ημερομηνία χρέωσης

Οι ριπές αιτημάτων περιορίζονται ανά κλειδί — εφαρμόστε εκθετική αναμονή (exponential backoff) στο 429. Ερωτήσεις; Επικοινωνήστε μαζί μας ή ανοίξτε αίτημα υποστήριξης.

API για developers