دستگاههای اپ
دستگاههای ثبتشده با فیلتر و صفحهبندی.
GET
scope: broker.readhttps://api.irnoti.com/v1/sdk-apps/{id}/devicesstatus: active، inactive یا unregistered. linked=true فقط دستگاههای وصلشده به مخاطب دفترچه. q در شناسهٔ بیرونی و موبایل/نام مخاطب جستوجو میکند.
پارامترها
| نام | محل | نوع | توضیح |
|---|---|---|---|
| id * | مسیر | string | شناسهٔ اپ. |
| page | query | integer | صفحه (پیشفرض ۱). |
| pageSize | query | integer | اندازه (۱ تا ۱۰۰، پیشفرض ۲۵). |
| externalId | query | string | شناسهٔ کاربر در سامانهٔ شما. |
| status | query | string | وضعیت دستگاه. |
| linked | query | string | true یا false. |
| q | query | string | جستوجو. |
خطاهای خاص این endpoint
| 401 | unauthorized | کلید API نامعتبر یا منقضی است. |
| 403 | insufficient_scope | کلید API دامنهٔ دسترسی لازم را ندارد. |
| 404 | not_found | اپ پیدا نشد یا متعلق به شما نیست. |
اجرای زنده (محیط تست)
باز کردن در کنسول کامل ←این endpoint در محیط تست پشتیبانی نمیشود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.