اعلانها و ایمیل
هر رویداد مهم هم بهصورت اعلان درونبرنامهای ثبت میشود و هم ایمیل میشود. اعلان درونبرنامهای همیشه ساخته میشود؛ ایمیل تابع تنظیمات کاربر است.
دستهبندیها
| کلید | دسته | شامل |
|---|---|---|
| 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برای اطلاعرسانی به سرور خودتان (نه به کاربر)، بهجای این بخش ازوبهوکاستفاده کنید.