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

فعال‌سازی وب‌پوش

کلید VAPID می‌سازد (یا می‌چرخاند) و کلید عمومی را برمی‌گرداند.

POSThttps://api.irnoti.com/v1/sdk-apps/{id}/webpush
scope: broker.write

subject باید mailto: یا https:// باشد. با rotate: true کلید جدید جایگزین می‌شود و مشترکین باید دوباره مشترک شوند. فقط مالک؛ سقف ۱۰ بار در ساعت.

پارامترها

ناممحلنوعتوضیح
id *مسیرstringشناسهٔ اپ.
subject *بدنهstringمثل mailto:admin@example.com.
rotateبدنهbooleanساخت کلید تازه.

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

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.
400validation_errorورودی نامعتبر است (جزئیات در پاسخ).
429rate_limitedتعداد درخواست از سقف مجاز بیشتر شد؛ پس از زمان Retry-After دوباره تلاش کنید.

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

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

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

curl -X POST 'https://api.irnoti.com/v1/sdk-apps/8/webpush' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "subject": "mailto:admin@example.com"
}'
پاسخ نمونه200 OK
{
  "publicKey": "BN…",
  "configured": true
}
فعال‌سازی وب‌پوش — مستندات API | ایران ناتیفیکیشن