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

دستگاه‌های اپ

دستگاه‌های ثبت‌شده با فیلتر و صفحه‌بندی.

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

status: active، inactive یا unregistered. linked=true فقط دستگاه‌های وصل‌شده به مخاطب دفترچه. q در شناسهٔ بیرونی و موبایل/نام مخاطب جست‌وجو می‌کند.

پارامترها

ناممحلنوعتوضیح
id *مسیرstringشناسهٔ اپ.
pagequeryintegerصفحه (پیش‌فرض ۱).
pageSizequeryintegerاندازه (۱ تا ۱۰۰، پیش‌فرض ۲۵).
externalIdquerystringشناسهٔ کاربر در سامانهٔ شما.
statusquerystringوضعیت دستگاه.
linkedquerystringtrue یا false.
qquerystringجست‌وجو.

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

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.
404not_foundاپ پیدا نشد یا متعلق به شما نیست.

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

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

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

curl -X GET 'https://api.irnoti.com/v1/sdk-apps/8/devices?status=active&pageSize=2' \
  -H "Authorization: Bearer $IRNOTI_KEY"
پاسخ نمونه200 OK
{
  "items": [
    {
      "id": "dev_301",
      "status": "active",
      "platform": "android",
      "externalId": "user-77",
      "lastSeenAt": "2026-10-30T09:00:00.000Z"
    }
  ],
  "total": 1840
}
دستگاه‌های اپ — مستندات API | ایران ناتیفیکیشن