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

اتصال دستگاه به مخاطب

دستگاه را به یک مخاطب موجود یا جدید وصل می‌کند.

PUThttps://api.irnoti.com/v1/sdk-apps/{id}/devices/{deviceId}/contact
scope: broker.write

با آن، همان شخص با پیامک و ربات هم قابل دسترسی می‌شود. یا contactId بدهید یا contact (موبایل، نام، نام خانوادگی، شرکت، ایمیل، شهر، یادداشت، تولد شمسی).

پارامترها

ناممحلنوعتوضیح
id *مسیرstringشناسهٔ اپ.
deviceId *مسیرstringشناسهٔ دستگاه (dev_… یا عدد).
contactIdبدنهstringشناسهٔ مخاطب موجود.
contactبدنهobjectمشخصات مخاطب جدید/به‌روزشده.

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

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

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

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

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

curl -X PUT 'https://api.irnoti.com/v1/sdk-apps/8/devices/dev_301/contact' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "contact": {
    "name": "علی",
    "mobile": "09121234567"
  }
}'
پاسخ نمونه200 OK
{
  "deviceId": "dev_301",
  "contactId": "801"
}
اتصال دستگاه به مخاطب — مستندات API | ایران ناتیفیکیشن