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

جست‌وجوی مخاطب برای اتصال

مخاطبان دفترچهٔ مالک را بر اساس موبایل/ایمیل/نام می‌یابد.

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

برای وصل کردن دستگاه به یک مخاطب موجود. سقف ۱۲۰ در دقیقه.

پارامترها

ناممحلنوعتوضیح
id *مسیرstringشناسهٔ اپ.
qquerystringعبارت جست‌وجو (≤۱۰۰).

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

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

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

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

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

curl -X GET 'https://api.irnoti.com/v1/sdk-apps/8/contacts?q=0912' \
  -H "Authorization: Bearer $IRNOTI_KEY"
پاسخ نمونه200 OK
[
  {
    "id": "801",
    "name": "علی",
    "mobile": "09121234567"
  }
]
جست‌وجوی مخاطب برای اتصال — مستندات API | ایران ناتیفیکیشن