شروعِ سریع
در چهار قدم، اولین ایمیلت را بفرست.
ارسال با SMTP
این مقادیر را در هر برنامهای که SMTP میپذیرد (وردپرس، لاراول، اسکریپتها و…) وارد کن.
| پارامتر | مقدار |
|---|---|
| سرور (Host) | smtp.mailerino.com |
| پورت | 587 (STARTTLS) — یا 2525 |
| نام کاربری | نامکاربریِ اعتبارنامهٔ SMTP |
| گذرواژه | گذرواژهٔ اعتبارنامهٔ SMTP |
| رمزنگاری | STARTTLS |
نمونهکد
import nodemailer from "nodemailer"; const t = nodemailer.createTransport({ host: "smtp.mailerino.com", port: 587, auth: { user: "YOUR_SMTP_USER", pass: "YOUR_SMTP_PASS" }, }); await t.sendMail({ from: "no-reply@yourdomain.ir", to: "user@example.com", subject: "کد ورود", text: "کد شما: ۸۴۲۱۹", });
$mail = new PHPMailer(true); $mail->isSMTP(); $mail->Host = "smtp.mailerino.com"; $mail->Port = 587; $mail->SMTPAuth = true; $mail->Username = "YOUR_SMTP_USER"; $mail->Password = "YOUR_SMTP_PASS"; $mail->setFrom("no-reply@yourdomain.ir"); $mail->addAddress("user@example.com"); $mail->Subject = "کد ورود"; $mail->Body = "کد شما: ۸۴۲۱۹"; $mail->send();
import smtplib from email.message import EmailMessage msg = EmailMessage() msg["From"] = "no-reply@yourdomain.ir" msg["To"] = "user@example.com" msg["Subject"] = "کد ورود" msg.set_content("کد شما: ۸۴۲۱۹") with smtplib.SMTP("smtp.mailerino.com", 587) as s: s.starttls() s.login("YOUR_SMTP_USER", "YOUR_SMTP_PASS") s.send_message(msg)
# فایل .env پروژهٔ لاراول
MAIL_MAILER=smtp
MAIL_HOST=smtp.mailerino.com
MAIL_PORT=587
MAIL_USERNAME=YOUR_SMTP_USER
MAIL_PASSWORD=YOUR_SMTP_PASS
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=no-reply@yourdomain.ir
ارسال با API
برای ارسالِ مستقیم با HTTP، یک کلیدِ فقطارسال از پنل بساز و در هدرِ Authorization بگذار.
POST https://api.mailerino.com/v1/send
فیلدهای بدنه
| فیلد | نوع | توضیح |
|---|---|---|
| from الزامی | string | آدرسِ فرستنده روی دامنهٔ تأییدشده. |
| to الزامی | string | ایمیلِ گیرنده. |
| subject الزامی | string | موضوعِ ایمیل. |
| text اختیاری | string | متنِ ساده. |
| html اختیاری | string | نسخهٔ HTML. |
| replyTo اختیاری | string | آدرسِ پاسخ. |
درخواست
curl -X POST https://api.mailerino.com/v1/send \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "from": "no-reply@yourdomain.ir", "to": "user@example.com", "subject": "کد ورود", "text": "کد شما: ۸۴۲۱۹" }'
const res = await fetch("https://api.mailerino.com/v1/send", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json", }, body: JSON.stringify({ from: "no-reply@yourdomain.ir", to: "user@example.com", subject: "کد ورود", text: "کد شما: ۸۴۲۱۹", }), });
$ch = curl_init("https://api.mailerino.com/v1/send"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer YOUR_API_KEY", "Content-Type: application/json", ], CURLOPT_POSTFIELDS => json_encode([ "from" => "no-reply@yourdomain.ir", "to" => "user@example.com", "subject" => "کد ورود", "text" => "کد شما: ۸۴۲۱۹", ]), CURLOPT_RETURNTRANSFER => true, ]); $response = curl_exec($ch);
پاسخ — 200 OK
{
"id": "msg_8f2a91c4",
"status": "queued"
}
کدِ id همان کدِ پیگیری است؛ وضعیتِ بعدیِ ایمیل را در «لاگِ رویدادها» یا با وبهوک دنبال کن.
احرازِ دامنه
تا از آدرسِ دامنهٔ خودت (مثلِ no-reply@yourdomain.ir) بفرستی، باید دامنه را تأیید کنی. در پنل به «دامنهها» برو، دامنه را اضافه کن و سه رکوردِ زیر را در DNS بگذار:
| رکورد | کارکرد |
|---|---|
| SPF | اعلام میکند ارسال از طرفِ میلرینو مجاز است. |
| DKIM | امضای دیجیتالِ ایمیلها برای صحت. |
| DMARC | سیاستِ برخورد با ایمیلهای جعلی. |
بعد از افزودنِ رکوردها، تأیید بهصورتِ خودکار انجام میشود (انتشارِ DNS گاهی تا چند ساعت طول میکشد).
وبهوک
با وبهوک، هر رویدادِ ایمیل همان لحظه به آدرسی که تعیین میکنی POST میشود تا سیستمت بلافاصله باخبر شود. رویدادها:
- sent — ایمیل ارسال شد.
- delivered — به سرورِ گیرنده تحویل شد.
- opened / clicked — باز یا کلیک شد.
- bounced / complained — بازگشت یا شکایت (خودکار به لیستِ تعلیق میرود).
نمونهٔ payload
{
"event": "delivered",
"email": "user@example.com",
"messageId": "msg_8f2a91c4",
"timestamp": "2026-06-17T12:04:21Z"
}
کدهای خطا
در صورتِ خطا، پاسخ با کدِ وضعیتِ مناسب و یک پیامِ فارسی برمیگردد.
| وضعیت | کد | معنی |
|---|---|---|
| 400 | validation | اطلاعاتِ ارسالشده معتبر نیست؛ مقادیر را بررسی کن. |
| 401 | invalid_api_key | کلیدِ API نامعتبر است یا منقضی شده است. |
| 402 | insufficient_credits | اعتبارِ حساب برای این عملیات کافی نیست. |
| 403 | forbidden | این کلید اجازهٔ این عملیات را ندارد. |
| 422 | domain_not_verified | دامنهٔ فرستنده هنوز تأیید نشده است. |
| 429 | rate_limited | تعدادِ درخواستها بیش از حدِ مجاز است؛ کمی بعد دوباره تلاش کن. |
| 503 | server_error | سرویس موقتاً در دسترس نیست؛ کمی بعد دوباره تلاش کن. |
محدودیتها
- سقفِ ارسالِ روزانه: بهصورتِ پیشفرض ۱۰۰۰ ایمیل در روز؛ با رشدِ حساب قابلِ افزایش است.
- محدودیتِ نرخ: درخواستهای API نرخِ معقولی دارند؛ در صورتِ عبور، پاسخِ 429 میگیری.
- فرستنده: آدرسِ فرستنده فقط روی دامنهٔ تأییدشده مجاز است.
- اعتبار: برای هر ارسال باید اعتبارِ کافی در حساب باشد.