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

همهٔ مخاطبان

همهٔ افراد دفترچه (پیامک، ایمیل، دستگاه‌های اپ، فرم‌ها).

GEThttps://api.irnoti.com/v1/phonebook/contacts
scope: phonebook.read

groupless=1 فقط مخاطبانی را می‌دهد که در هیچ گروهی نیستند.

پارامترها

ناممحلنوعتوضیح
qquerystringعبارت جست‌وجو.
grouplessquerystring1 یا true برای مخاطبان بدون گروه.
pagequeryintegerشمارهٔ صفحه.
pageSizequeryintegerاندازهٔ صفحه.
takequeryintegerتعداد (حالت مکان‌نما).
afterquerystringشناسهٔ آخرین ردیف.

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

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

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

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

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

curl -X GET 'https://api.irnoti.com/v1/phonebook/contacts?take=20&groupless=1' \
  -H "Authorization: Bearer $IRNOTI_KEY"
پاسخ نمونه200 OK
[
  {
    "id": "801",
    "name": "علی",
    "email": null,
    "mobile": "09121234567"
  }
]
همهٔ مخاطبان — مستندات API | ایران ناتیفیکیشن