Αποστολή email

Επισκόπηση

Δημιουργήστε κλειδιά στο Λογαριασμός → Τομείς → ο τομέας σας → API μετά την ολοκλήρωση της επαλήθευσης DNS. Το πλήρες μυστικό εμφανίζεται μία φορά — αποθηκεύστε το με ασφάλεια. Προαιρετικά διαπιστευτήρια SMTP στον ίδιο πίνακα Τομέων ακολουθούν τους ίδιους κανόνες μόνο συναλλαγών.

Μόνο συναλλακτική αλληλογραφία

Unbox HTTP API (POST /v1/email) and optional SMTP submission are for transactional mail only — messages tied to an account action, purchase, or operational event. They are not a newsletter or marketing broadcast service.

Επιτρεπόμενες χρήσεις

• Επαλήθευση λογαριασμού, επαναφορά κωδικού πρόσβασης και ειδοποιήσεις ασφαλείας
• Επιβεβαιώσεις παραγγελιών, αποδείξεις, ενημερώσεις αποστολής και ειδοποιήσεις πληρωμών
• Ειδοποιήσεις που ενεργοποιούνται από συγκεκριμένο χρήστη ή συμβάν συστήματος
• Μηνύματα ομάδας και χώρου εργασίας (προσκλήσεις, αναθέσεις, εσωτερικές ειδοποιήσεις)

Απαγορευμένες χρήσεις

• Ενημερωτικά δελτία, διαφημιστικές καμπάνιες ή μαζικό μάρκετινγκ
• Ψυχρή προσέγγιση ή αποστολή σε αγορασμένες, συλλεγμένες ή λίστες χωρίς συγκατάθεση
• Spam συνεργατών, phishing ή παραπλανητικό περιεχόμενο
• Οποιαδήποτε απόπειρα παράκαμψης ορίων παραληπτών, ορίων ρυθμού ή ποσοστώσεων προγράμματος

Όρια ρυθμού και παραληπτών

Για την προστασία των παραληπτών και της αποδοτικότητας παράδοσης, η εξερχόμενη κίνηση API και SMTP υπόκειται στα παρακάτω όρια (επιπλέον της μηνιαίας εξερχόμενης ποσόστωσης του προγράμματός σας). Η επιβολή είναι ενεργή στο web composer, στο HTTP API και στην υποβολή SMTP. Το web composer προειδοποιεί μετά από 25 παραλήπτες ανά μήνυμα και αποκλείει αποστολές άνω των 50.

Αυτοί οι κανόνες αποτελούν μέρος της Πολιτικής Αποδεκτής Χρήσης μας. Η αυτοματοποιημένη επιβολή είναι ενεργή στο web composer, στο HTTP API και στην υποβολή SMTP. Λογαριασμοί που στέλνουν διαφημιστικά ή μαζικά μηνύματα ή κακοποιούν την υποδομή αποστολής, ενδέχεται να περιοριστούν, να ανασταλούν ή να τερματιστούν.

Παρακολουθούμε σήματα αποδοτικότητας παράδοσης. Σταθερά ποσοστά αναπήδησης άνω του 3% ή ποσοστά παραπόνων άνω του 0,1% ενδέχεται να ενεργοποιήσουν προσωρινή παύση αποστολής ή χειροκίνητη αναθεώρηση.

Δείτε τους Όρους Παροχής Υπηρεσιών, την Πολιτική Απορρήτου και τη Δήλωση GDPR για πλήρεις λεπτομέρειες πολιτικής.

Αυθεντικοποίηση

Στείλτε το κλειδί API του τομέα σας σε κάθε αίτημα:

Authorization: Bearer ubk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Εναλλακτικά, χρησιμοποιήστε X-Api-Key: ubk_live_…. Τα κλειδιά αποθηκεύονται κατακερματισμένα· ανακαλέστε ή αλλάξτε τα από τον πίνακα ελέγχου Τομέων.

Σώμα αιτήματος

JSON με ονόματα πεδίων σε PascalCase (From, To, …). Γίνονται αποδεκτά και ψευδώνυμα camelCase.

Παράδειγμα

{
  "From": "you@yourdomain.com",
  "To": "user@example.com",
  "Subject": "Welcome",
  "TextBody": "Thanks for signing up.",
  "HtmlBody": "<p>Thanks for signing up.</p>",
  "ReplyTo": "you@yourdomain.com",
  "Tag": "welcome"
}

Απόκριση επιτυχίας

HTTP 200 με JSON:

{
  "ErrorCode": 0,
  "Message": "OK",
  "MessageID": "0100018…-000000-…",
  "SubmittedAt": "2026-06-23T12:00:00.000Z",
  "To": "user@example.com"
}

Αποκρίσεις σφαλμάτων

Τα σφάλματα επιστρέφουν 4xx (ή 500 για απροσδόκητες αποτυχίες) με JSON:

{
  "ErrorCode": 300,
  "Message": "TextBody or HtmlBody is required."
}

Παραδείγματα

Αντικαταστήστε το you@yourdomain.com με το προσωπικό σας γραμματοκιβώτιο στον τομέα και χρησιμοποιήστε το δικό σας κλειδί API.

curl "https://api.unbox.im/v1/email" \
  -H "Authorization: Bearer ubk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "From": "you@yourdomain.com",
  "To": "user@example.com",
  "Subject": "Welcome",
  "TextBody": "Thanks for signing up.",
  "HtmlBody": "<p>Thanks for signing up.</p>",
  "ReplyTo": "you@yourdomain.com",
  "Tag": "welcome"
}'