API ایمیل
از کد خودتان بفرستید، دقیقاً یک بار.
یک فراخوانی یک پیام یا دستهای صدتایی میفرستد. هر ارسال پیش از رفتن شناسه دارد و تلاش دوباره بهجای ارسال مجدد، همان نتیجه اول را برمیگرداند.
خلاصه
API ایمیل تراکنشی چیست؟
راهی است که یک برنامه نامههای خودش مثل رسید، پیوند ورود و هشدار را با یک درخواست HTTP میفرستد، بهجای آنکه کسی دکمه ارسال را بزند.
100
پیام در یک فراخوانی دستهای
365
روز که ارسال را میتوان از پیش زمانبندی کرد
900
ثانیه برای لغو یک ارسال فوری
چطور کار میکند
دستهای که هرگز همه یا هیچ نیست
تا 100 پیام در هر فراخوانی، هرکدام جداگانه بررسی میشود. یک نشانی نادرست فقط همان مورد را ناموفق میکند و بقیه میروند.
حالا، بعداً یا با فرصت لغو
تا یک سال جلوتر زمانبندی کنید یا یک ارسال فوری را تا 15 دقیقه نگه دارید. تا وقتی نرفته، لغو یا جابهجایش کنید.
ردی برای هر پیام
هر ارسال بیدرنگ یک شناسه msg_ میگیرد. وضعیتش، رویدادهای هر گیرنده و باز شدنها و کلیکهایش را بخوانید.
یک دسته بفرستید
SDK تایپاسکریپت، یا همان JSON با HTTP ساده.
import { init, openemail } from '@openemail/sdk' init({ apiKey: process.env.OPENEMAIL_API_KEY }) const result = await openemail.emails.sendBatch( [ { from: '[email protected]', to: '[email protected]', subject: 'Order AC-4192 has shipped', text: 'It is on its way.' }, { from: '[email protected]', to: '[email protected]', subject: 'Order AC-4193 has shipped', text: 'It is on its way.' }, ], { idempotencyKey: 'shipments:2026-09-23' },) console.log(result.sent, result.failed)چه به دست میآورید
امروز در محصول
قالب با شناسه
یک قالب ذخیرهشده را بفرستید و نسخهای را که آزمودهاید ثابت کنید.
به زبان خودشان
translate را اضافه کنید تا هر گیرنده آن را به زبان خودش بخواند، وگرنه اصلاً فرستاده نمیشود.
به شکل Resend هم
SDK Resend را به /compat/resend اشاره دهید و کدتان را نگه دارید.
روشهای خوب
بیشترین بهره از آن
- 01
کلید idempotency را استخراج کنید
از علت ارسال استفاده کنید، مثل شماره سفارش، هرگز از مهر زمانی.
- 02
وضعیت را بخوانید
202 یعنی در صف یا زمانبندیشده. پیش از اینکه آن را تحویلشده بدانید، status را ببینید.
- 03
به ارسالها برچسب بزنید
تا 10 برچسب برای هر پیام، که در هر بار خواندن برمیگردند.
وضعیت فعلی
خوب است بدانید
- بدون حالت آزمایشی
- همه کلیدها واقعیاند، پس هر ارسال واقعاً تحویل داده میشود.
- بدون وضعیت برگشت روی ارسال
- برگشت به گفتگو و وبهوک email.bounced میرسد، نه به GET /emails.
- ارسالهای ویرایشگر فهرست نمیشوند
- نامهای که از برنامه فرستاده شود در GET /emails دیده نمیشود.
پرسشها
اغلب میپرسند
ادامه دهید
با اینها خوب کار میکند
شروع
دامنهی خودتان،
ایمیل خودتان.
دامنهای را به OpenEmail متصل کنید و نامههایش را در صندوق پستیای بخوانید که گرد آن ساخته شده است. طرح رایگان یک دامنه را پوشش میدهد.