Trimite e-mail

Prezentare generală

Generați chei în Cont → Domenii → domeniul dvs. → API după finalizarea verificării DNS. Secretul complet este afișat o singură dată — păstrați-l în siguranță. Credențialele SMTP opționale din același panou Domenii respectă aceleași reguli de doar tranzacțional.

Doar e-mailuri tranzacționale

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.

Utilizări permise

• Verificare cont, resetare parolă și alerte de securitate
• Confirmări de comandă, chitanțe, actualizări de livrare și notificări de plată
• Notificări declanșate de un anumit utilizator sau eveniment de sistem
• Mesaje de echipă și spațiu de lucru (invitații, atribuiri, alerte interne)

Utilizări interzise

• Newslettere, campanii promoționale sau marketing de difuzare
• Contactare la rece sau e-mailuri către liste cumpărate, răzuite sau fără consimțământ
• Spam afiliat, phishing sau conținut înșelător
• Orice încercare de a ocoli plafoanele de destinatari, limitele de rată sau cotele planului

Limite de rată și destinatari

Pentru a proteja destinatarii și livrabilitatea, traficul API și SMTP de ieșire este supus limitelor de mai jos (pe lângă cota lunară de ieșire a planului tău). Aplicarea este activă pe compozitorul web, HTTP API și SMTP submission. Compozitorul web avertizează după 25 de destinatari per mesaj și blochează trimiterile peste 50.

Aceste reguli fac parte din Politica noastră de utilizare acceptabilă. Aplicarea automată este activă pe compozitorul web, HTTP API și SMTP submission. Conturile care trimit e-mailuri de marketing sau în masă, sau care abuzează în alt mod de infrastructura de trimitere, pot fi limitate, suspendate sau terminate.

Monitorizăm semnalele de livrabilitate. Rate de respingere susținute peste 3% sau rate de reclamații peste 0,1% pot declanșa o pauză temporară de trimitere sau o revizuire manuală.

Vezi Termenii de utilizare, Politica de confidențialitate și Declarația GDPR pentru detalii complete despre politici.

Autentificare

Trimiteți cheia API a domeniului dvs. la fiecare cerere:

Authorization: Bearer ubk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Alternativ, utilizați X-Api-Key: ubk_live_…. Cheile sunt stocate sub formă de hash; revocați sau rotiți-le din tabloul de bord Domenii.

Corpul cererii

JSON cu nume de câmpuri în PascalCase (From, To, …). Aliasurile camelCase sunt de asemenea acceptate.

Exemplu

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

Răspuns de succes

HTTP 200 cu JSON:

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

Răspunsuri de eroare

Erorile returnează 4xx (sau 500 pentru defecțiuni neașteptate) cu JSON:

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

Exemple

Înlocuiește you@yourdomain.com cu căsuța ta poștală personală de pe domeniu și folosește propria cheie 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"
}'