aidoom

اعلان‌ها و ایمیل

هر رویداد مهم هم به‌صورت اعلان درون‌برنامه‌ای ثبت می‌شود و هم ایمیل می‌شود. اعلان درون‌برنامه‌ای همیشه ساخته می‌شود؛ ایمیل تابع تنظیمات کاربر است.

دسته‌بندی‌ها

کلیددستهشامل
securityامنیت حسابکد ورود، تغییر رمز، ساخت کلید API — همیشه ارسال می‌شود و قابل خاموش‌کردن نیست.
jobsپردازش‌هاآماده‌شدن یا ناموفق‌بودن پردازش.
billingپرداخت و اعتباررسید پرداخت، تمدید اشتراک، هشدار اتمام اعتبار.
accountحساب کاربریخوش‌آمدگویی و تغییرات مهم حساب.
promoپیشنهادهاتخفیف‌ها و کمپین‌ها. به‌صورت پیش‌فرض خاموش است (opt-in).
ایمیل‌های دستهٔ security هرگز خاموش نمی‌شوند و لینک لغو اشتراک ندارند. اگر کسی به حساب شما دسترسی بگیرد، همین ایمیل‌ها تنها راه باخبرشدن شماست.

خواندن اعلان‌ها

# فهرست اعلان‌ها
curl "https://aidoom.ir/api/notifications?limit=20" \
  -H "Authorization: Bearer $API_KEY"

# فقط تعداد خوانده‌نشده‌ها (سبک، مناسب polling)
curl "https://aidoom.ir/api/notifications/unread-count" \
  -H "Authorization: Bearer $API_KEY"

پاسخ

bash
{
  "data": [
    {
      "id": "clx…",
      "type": "job.completed",
      "category": "jobs",
      "titleFa": "«تعویض چهره» آماده شد",
      "bodyFa": "نتیجهٔ پردازش شما آمادهٔ دریافت است.",
      "href": "/dashboard/jobs?job=job_9fK2xQ",
      "readAt": null,
      "createdAt": "2026-09-08T07:12:44.000Z"
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 34, "unread": 3 }
}

علامت‌زدن به‌عنوان خوانده‌شده

bash
curl -X POST "https://aidoom.ir/api/notifications/{id}/read" \
  -H "Authorization: Bearer $API_KEY"

# یا همه با هم
curl -X POST "https://aidoom.ir/api/notifications/read-all" \
  -H "Authorization: Bearer $API_KEY"

تنظیمات ایمیل

هر دسته را جداگانه می‌توان خاموش یا روشن کرد — به‌جزsecurityکه همیشه فعال است و در صورت ارسال، نادیده گرفته می‌شود.

bash
# خواندن تنظیمات فعلی
curl "https://aidoom.ir/api/notifications/preferences" \
  -H "Authorization: Bearer $API_KEY"

# خاموش‌کردن ایمیل پردازش‌ها، روشن‌کردن پیشنهادها
curl -X PATCH "https://aidoom.ir/api/notifications/preferences" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "jobs": false, "promo": true }'

لغو اشتراک با یک کلیک

هر ایمیل غیرامنیتی هدرهای استانداردList-Unsubscribeرا دارد، بنابراین دکمهٔ لغو اشتراک خودِ Gmail و Apple Mail کار می‌کند. لینک داخل ایمیل هم بدون نیاز به ورود عمل می‌کند.

bash
List-Unsubscribe: <https://…/unsubscribe?t=TOKEN&c=promo>
List-Unsubscribe-Post: List-Unsubscribe=One-Click
برای اطلاع‌رسانی به سرور خودتان (نه به کاربر)، به‌جای این بخش ازوب‌هوکاستفاده کنید.