ایران ناتیفیکیشن

ذخیرهٔ پیش‌نویس

پیش‌نویس جدید می‌سازد یا با `id` پیش‌نویس موجود را ویرایش می‌کند.

POSThttps://api.irnoti.com/v1/email/drafts
scope: email.manage

پیش‌نویس در پوشهٔ drafts همان صندوق ذخیره می‌شود. برای ارسال آن، draftId را در POST /email/send بدهید.

پارامترها

ناممحلنوعتوضیح
idبدنهstringشناسهٔ پیش‌نویس برای ویرایش.
mailboxId *بدنهstringصندوق مبدا.
toبدنهstring[]گیرندگان.
ccبدنهstring[]رونوشت.
bccبدنهstring[]رونوشت مخفی.
subjectبدنهstringموضوع.
textبدنهstringمتن ساده.
htmlبدنهstringمتن HTML.

خطاهای خاص این endpoint

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.
404not_foundصندوق پیدا نشد یا متعلق به شما نیست.
400validation_errorورودی نامعتبر است؛ خطای هر فیلد در details آمده است.

اجرای زنده (محیط تست)

باز کردن در کنسول کامل ←

این endpoint در محیط تست پشتیبانی نمی‌شود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.

curl -X POST 'https://api.irnoti.com/v1/email/drafts' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "to": [
    "customer@gmail.com"
  ],
  "html": "<p>سلام</p>",
  "subject": "پیشنهاد همکاری",
  "mailboxId": "12"
}'
پاسخ نمونه200 OK
{
  "id": "9930"
}
ذخیرهٔ پیش‌نویس — مستندات API | ایران ناتیفیکیشن