Ζητήστε πρώιμη πρόσβαση

Συμπληρώστε το όνομά σας και ένα email ή έναν αριθμό τηλεφώνου. Θα σας στείλουμε πληροφορίες για την πρόσβαση στο Tajo.

Αποστολή email

Στείλτε μεμονωμένα συναλλακτικά email χρησιμοποιώντας το endpoint /v3/smtp/email.

Endpoint

POST /v3/smtp/email

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

Βασικό email

{
  "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><p>Thank you for signing up.</p></body></html>"
}

Προχωρημένο email

{
  "sender": {
    "name": "Your App",
    "email": "[email protected]"
  },
  "to": [
    {
      "email": "[email protected]",
      "name": "John Doe"
    }
  ],
  "cc": [
    {
      "email": "[email protected]",
      "name": "CC User"
    }
  ],
  "bcc": [
    {
      "email": "[email protected]"
    }
  ],
  "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>";
  sendSmtpEmail.sender = { name: "Your App", email: "[email protected]" };
  sendSmtpEmail.to = [{ email: "[email protected]", name: "John Doe" }];

  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_sdk
from 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(
    to=[{"email": "[email protected]", "name": "John Doe"}],
    sender={"name": "Your App", "email": "[email protected]"},
    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)

{
  "messageId": "<[email protected]>"
}

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

Μη έγκυρο κλειδί 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 πριν από την αποστολή
Χειρίζεστε ομαλά τα σφάλματα με λογική επανάληψης

Όρια ρυθμού

Δωρεάν λογαριασμοί: 300 email ανά ημέρα
Επί πληρωμή λογαριασμοί: ανάλογα με το πρόγραμμά σας
Όριο ριπής: 100 email ανά λεπτό

Παρακολούθηση

Τα email που στέλνονται μέσω αυτού του endpoint παρακολουθούνται αυτόματα για:

Κατάσταση παράδοσης
Ποσοστά ανοίγματος
Παρακολούθηση κλικ
Διαχείριση μη παραδοθέντων (bounce)

Δείτε αναλυτικά στατιστικά στον πίνακα ελέγχου του Brevo, στην ενότητα Statistics → Transactional.

Σχετικά endpoints

Πρότυπα email
Συνημμένα
Στατιστικά email

Συναλλακτικά Email

Συναλλακτικά SMS

Επαφές

Συμβάντα