ارسال پوش
پوش را به همهٔ دستگاهها، یک موضوع، شناسهها، موبایلها، گروه دفترچه یا یک بخشبندی میفرستد.
https://api.irnoti.com/v1/sdk-apps/{id}/sendدقیقاً با یکی از حالتهای target مخاطب را مشخص کنید:
- all: true همهٔ دستگاهها
- topic
- externalIds یا deviceIds (تا ۱۰۰۰)
- phones (موبایلهایی که کاربر در اپ معرفی کرده)
- groupId گروه دفترچه
- segment ترکیب شرطها: platform، locale، appVersion، tags، activeWithinDays، identified، country، city، near {lat, lon, radiusKm}، performed (رویداد گزارششده)
**امکانات:** زمانبندی (sendAt، حداکثر ۳۰ روز)، ساعت محلی هر دستگاه (sendLocal.time)، ساعت سکوت (quietHours)، آزمون A/B (variants با سهم درصدی) و پیامک جایگزین برای دستگاههای ناموفق (smsFallback.text).
**پیام:** title، body، image، url/deepLink، data و … طبق ساختار پیام SDK. سقف ۶۰ درخواست در دقیقه.
پارامترها
| نام | محل | نوع | توضیح |
|---|---|---|---|
| id * | مسیر | string | شناسهٔ اپ. |
| message * | بدنه | object | محتوای پوش (عنوان، متن، تصویر، لینک، داده). |
| target * | بدنه | object | مخاطب (بالا). |
| sendAt | بدنه | string (ISO 8601) | ارسال بعداً (حداکثر ۳۰ روز). |
| sendLocal | بدنه | object | { time: "HH:MM" } ارسال با ساعت محلی هر دستگاه؛ همراه sendAt نمیآید. |
| quietHours | بدنه | object | { from, to } (HH:MM) بازهٔ سکوت؛ ممکن است از نیمهشب بگذرد. |
| variants | بدنه | object[] | تا ۳ نسخه: { message, percent }؛ جمع درصدها ≤۹۹. |
| smsFallback | بدنه | object | { text } پیامک جایگزین (فقط اپ شخصی). |
خطاهای خاص این endpoint
| 401 | unauthorized | کلید API نامعتبر یا منقضی است. |
| 403 | insufficient_scope | کلید API دامنهٔ دسترسی لازم را ندارد. |
| 400 | validation_error | ورودی نامعتبر است (جزئیات در پاسخ). |
| 404 | not_found | اپ پیدا نشد یا متعلق به شما نیست. |
| 429 | rate_limited | تعداد درخواست از سقف مجاز بیشتر شد؛ پس از زمان Retry-After دوباره تلاش کنید. |
اجرای زنده (محیط تست)
باز کردن در کنسول کامل ←این endpoint در محیط تست پشتیبانی نمیشود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.