Zatražite rani pristup

Unesite ime i poslovnu adresu e-pošte. Poslat ćemo vam poveznicu za potvrdu zahtjeva za pristup Taju.

Slanje e-pošte

Šaljite pojedinačne transakcijske poruke e-pošte pomoću krajnje točke /v3/smtp/email.

Krajnja točka

POST /v3/smtp/email

Tijelo zahtjeva

Osnovna poruka

{
"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>"
}

Napredna poruka

{
"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"
}
}

Primjeri koda

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

Terminal window
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>"
}'

Odgovor

Uspješan odgovor (201 Created)

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

Odgovori s pogreškom

Neispravan API ključ (401)

{
"code": "unauthorized",
"message": "Invalid API key provided"
}

Neispravan format adrese e-pošte (400)

{
"code": "invalid_parameter",
"message": "Invalid email format in 'to' field"
}

Prekoračeno ograničenje broja zahtjeva (429)

{
"code": "too_many_requests",
"message": "Rate limit exceeded"
}

Parametri

Obavezni parametri

ParametarTipOpis
senderobjectPodaci o pošiljatelju
toarrayNiz objekata s primateljima
subjectstringPredmet poruke

Neobavezni parametri

ParametarTipOpis
htmlContentstringHTML sadržaj poruke
textContentstringTekstualni sadržaj poruke
ccarrayPrimatelji kopije
bccarrayPrimatelji skrivene kopije
replyToobjectAdresa za odgovor
attachmentsarrayPrivici
paramsobjectParametri predloška
tagsarrayOznake poruke za praćenje
headersobjectPrilagođena zaglavlja

Varijable predloška

Koristite varijable predloška u predmetu i sadržaju poruke:

{
"subject": "Welcome {{firstName}}!",
"htmlContent": "<h1>Hello {{firstName}} {{lastName}}</h1>",
"params": {
"firstName": "John",
"lastName": "Doe"
}
}

Privici

Dodajte datoteke kao privitke:

{
"attachments": [
{
"content": "base64_encoded_content",
"name": "invoice.pdf"
},
{
"url": "https://example.com/document.pdf",
"name": "document.pdf"
}
]
}

Najbolje prakse

  1. Uvijek uključite i HTML i tekstualni sadržaj radi bolje isporučivosti
  2. Koristite varijable predloška umjesto spajanja sadržaja
  3. Navedite ispravne podatke o pošiljatelju kako biste izbjegli filtre neželjene pošte
  4. Dodajte oznake za praćenje i analitiku
  5. Provjerite valjanost adresa e-pošte prije slanja
  6. Obradite pogreške pažljivo uz logiku ponovnog pokušaja

Ograničenja broja zahtjeva

  • API ograničenje: na općoj razini, koju ima svaki plan, ova krajnja točka dopušta 1.000 zahtjeva u sekundi i 3.600.000 na sat. Napredna razina (Professional i Enterprise) dopušta 2.000 u sekundi, a proširena razina (Enterprise) 6.000.
  • Opseg slanja: koliko poruka e-pošte možete poslati određuje vaš Brevo plan, odvojeno od ograničenja broja zahtjeva.

Pogledajte Ograničenja broja zahtjeva i Brevo stranicu s ograničenjima.

Praćenje

Poruke poslane putem ove krajnje točke automatski se prate za:

  • Status isporuke
  • Stope otvaranja
  • Praćenje klikova
  • Obradu odbijenih poruka

Detaljnu analitiku pogledajte na svojoj Brevo nadzornoj ploči pod Statistics → Transactional.

Povezane krajnje točke

Zatražite rani pristup

Unesite ime i poslovnu adresu e-pošte. Poslat ćemo vam poveznicu za potvrdu zahtjeva za pristup Taju.

AI asistent

Bok! Pitajte me o dokumentaciji.

Ova stranica kao Markdown: send-email.md

Učitavanje Markdowna…
Otvori u Claude Otvori u ChatGPT