اتصال دستگاه به مخاطب
دستگاه را به یک مخاطب موجود یا جدید وصل میکند.
PUT
scope: broker.writehttps://api.irnoti.com/v1/sdk-apps/{id}/devices/{deviceId}/contactبا آن، همان شخص با پیامک و ربات هم قابل دسترسی میشود. یا contactId بدهید یا contact (موبایل، نام، نام خانوادگی، شرکت، ایمیل، شهر، یادداشت، تولد شمسی).
پارامترها
| نام | محل | نوع | توضیح |
|---|---|---|---|
| id * | مسیر | string | شناسهٔ اپ. |
| deviceId * | مسیر | string | شناسهٔ دستگاه (dev_… یا عدد). |
| contactId | بدنه | string | شناسهٔ مخاطب موجود. |
| contact | بدنه | object | مشخصات مخاطب جدید/بهروزشده. |
خطاهای خاص این endpoint
| 401 | unauthorized | کلید API نامعتبر یا منقضی است. |
| 403 | insufficient_scope | کلید API دامنهٔ دسترسی لازم را ندارد. |
| 400 | validation_error | ورودی نامعتبر است (جزئیات در پاسخ). |
| 404 | not_found | دستگاه پیدا نشد یا متعلق به شما نیست. |
| 429 | rate_limited | تعداد درخواست از سقف مجاز بیشتر شد؛ پس از زمان Retry-After دوباره تلاش کنید. |
اجرای زنده (محیط تست)
باز کردن در کنسول کامل ←این endpoint در محیط تست پشتیبانی نمیشود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.