Αποστολή email
Στείλτε μεμονωμένα συναλλακτικά email χρησιμοποιώντας το endpoint /v3/smtp/email.
Endpoint
POST /v3/smtp/emailΣώμα αιτήματος
Βασικό email
{ "sender": { "name": "Your App", }, "to": [ { "name": "John Doe" } ], "subject": "Welcome to our service!", "htmlContent": "<html><body><h1>Welcome!</h1><p>Thank you for signing up.</p></body></html>"}Προχωρημένο email
{ "sender": { "name": "Your App", }, "to": [ { "name": "John Doe" } ], "cc": [ { "name": "CC User" } ], "bcc": [ { } ], "subject": "Order Confirmation #{{order_id}}", "htmlContent": "<html><body><h1>Order Confirmed</h1><p>Your order {{order_id}} has been confirmed.</p></body></html>", "textContent": "Your order {{order_id}} has been confirmed.", "params": { "order_id": "12345" }, "tags": ["transactional", "order-confirmation"], "headers": { "X-Custom-Header": "custom-value" }}Παραδείγματα κώδικα
JavaScript/Node.js
const brevo = require('@getbrevo/brevo');
const apiInstance = new brevo.TransactionalEmailsApi();apiInstance.setApiKey(brevo.TransactionalEmailsApiApiKeys.apiKey, process.env.BREVO_API_KEY);
const sendEmail = async () => { const sendSmtpEmail = new brevo.SendSmtpEmail();
sendSmtpEmail.subject = "Welcome to our service!"; sendSmtpEmail.htmlContent = "<html><body><h1>Welcome!</h1></body></html>";
try { const result = await apiInstance.sendTransacEmail(sendSmtpEmail); console.log('Email sent:', result); return result; } catch (error) { console.error('Error sending email:', error); throw error; }};Python
import sib_api_v3_sdkfrom sib_api_v3_sdk.rest import ApiException
configuration = sib_api_v3_sdk.Configuration()configuration.api_key['api-key'] = 'YOUR_API_KEY'
api_instance = sib_api_v3_sdk.TransactionalEmailsApi(sib_api_v3_sdk.ApiClient(configuration))
send_smtp_email = sib_api_v3_sdk.SendSmtpEmail( subject="Welcome to our service!", html_content="<html><body><h1>Welcome!</h1></body></html>")
try: api_response = api_instance.send_transac_email(send_smtp_email) print(api_response)except ApiException as e: print("Exception when calling TransactionalEmailsApi->send_transac_email: %s\n" % e)cURL
curl -X POST "https://api.brevo.com/v3/smtp/email" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "api-key: YOUR_API_KEY" \ -d '{ "sender": { "name": "Your App", "email": "[email protected]" }, "to": [ { "email": "[email protected]", "name": "John Doe" } ], "subject": "Welcome to our service!", "htmlContent": "<html><body><h1>Welcome!</h1></body></html>" }'Απόκριση
Επιτυχής απόκριση (201 Created)
{}Αποκρίσεις σφάλματος
Μη έγκυρο κλειδί API (401)
{ "code": "unauthorized", "message": "Invalid API key provided"}Μη έγκυρη μορφή email (400)
{ "code": "invalid_parameter", "message": "Invalid email format in 'to' field"}Υπέρβαση ορίου ρυθμού (429)
{ "code": "too_many_requests", "message": "Rate limit exceeded"}Παράμετροι
Υποχρεωτικές παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
sender | object | Στοιχεία αποστολέα |
to | array | Πίνακας αντικειμένων παραληπτών |
subject | string | Θέμα του email |
Προαιρετικές παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
htmlContent | string | Περιεχόμενο HTML του email |
textContent | string | Περιεχόμενο απλού κειμένου του email |
cc | array | Παραλήπτες κοινοποίησης |
bcc | array | Παραλήπτες κρυφής κοινοποίησης |
replyTo | object | Διεύθυνση απάντησης |
attachments | array | Συνημμένα αρχεία |
params | object | Παράμετροι προτύπου |
tags | array | Ετικέτες email για παρακολούθηση |
headers | object | Προσαρμοσμένες κεφαλίδες |
Μεταβλητές προτύπου
Χρησιμοποιήστε μεταβλητές προτύπου στο θέμα και στο περιεχόμενό σας:
{ "subject": "Welcome {{firstName}}!", "htmlContent": "<h1>Hello {{firstName}} {{lastName}}</h1>", "params": { "firstName": "John", "lastName": "Doe" }}Συνημμένα
Συμπεριλάβετε συνημμένα αρχεία:
{ "attachments": [ { "content": "base64_encoded_content", "name": "invoice.pdf" }, { "url": "https://example.com/document.pdf", "name": "document.pdf" } ]}Βέλτιστες πρακτικές
- Συμπεριλαμβάνετε πάντα περιεχόμενο HTML και απλού κειμένου για καλύτερη παραδοσιμότητα
- Χρησιμοποιείτε μεταβλητές προτύπου αντί να συνενώνετε το περιεχόμενο
- Δηλώνετε σωστά στοιχεία αποστολέα για να αποφύγετε τα φίλτρα ανεπιθύμητης αλληλογραφίας
- Προσθέτετε ετικέτες για παρακολούθηση και ανάλυση
- Επικυρώνετε τις διευθύνσεις email πριν από την αποστολή
- Χειρίζεστε ομαλά τα σφάλματα με λογική επανάληψης
Όρια ρυθμού
- Όριο ρυθμού API: στο γενικό επίπεδο, που ισχύει για κάθε πρόγραμμα, αυτό το endpoint επιτρέπει 1.000 αιτήματα ανά δευτερόλεπτο και 3.600.000 ανά ώρα. Το προηγμένο επίπεδο (Professional και Enterprise) επιτρέπει 2.000 ανά δευτερόλεπτο και το εκτεταμένο επίπεδο (Enterprise) 6.000.
- Όγκος αποστολής: πόσα email μπορείτε να στείλετε καθορίζεται από το πρόγραμμά σας στο Brevo, ξεχωριστά από το όριο ρυθμού.
Δείτε τα Όρια ρυθμού και τη σελίδα ορίων του Brevo.
Παρακολούθηση
Τα email που στέλνονται μέσω αυτού του endpoint παρακολουθούνται αυτόματα για:
- Κατάσταση παράδοσης
- Ποσοστά ανοίγματος
- Παρακολούθηση κλικ
- Διαχείριση μη παραδοθέντων (bounce)
Δείτε αναλυτικά στατιστικά στον πίνακα ελέγχου του Brevo, στην ενότητα Statistics → Transactional.
Σχετικά endpoints
- Πρότυπα email
- Συνημμένα
- Στατιστικά email