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

ساخت فید

یک فید را به اپ وصل می‌کند.

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

در هر بررسی حداکثر maxPerRun (۱ تا ۵) مطلب جدید پوش می‌شود. سقف ۲۰ فید در ساعت.

پارامترها

ناممحلنوعتوضیح
id *مسیرstringشناسهٔ اپ.
name *بدنهstringنام.
url *بدنهstringنشانی فید (۸ تا ۵۰۰ نویسه).
intervalMinutesبدنهintegerبازهٔ بررسی (۱۵ تا ۱۴۴۰، پیش‌فرض ۶۰).
maxPerRunبدنهintegerسقف مطلب در هر بررسی (۱ تا ۵، پیش‌فرض ۳).
targetبدنهobjectمخاطب پوش؛ پیش‌فرض { all: true }.

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

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

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

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

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

curl -X POST 'https://api.irnoti.com/v1/sdk-apps/8/feeds' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://blog.example.com/feed",
  "name": "وبلاگ",
  "intervalMinutes": 60
}'
پاسخ نمونه200 OK
{
  "id": "2",
  "status": "active"
}
ساخت فید — مستندات API | ایران ناتیفیکیشن