فهرست مخاطبین

مخاطبین ایمیل با جستجو و فیلتر گروه.

GEThttps://api.irnoti.com/v1/email/contacts

scope: email.read

مخاطبین هنگام نوشتن نامه تکمیل خودکار می‌شوند و فرستندگان ناشناس هم پس از اولین نامه اضافه می‌شوند.

پارامترها

نام	محل	نوع	توضیح
q	query	string	جستجو در نام و نشانی.
group	query	string	نام گروه.
blocked	query	boolean	فقط مسدودشده‌ها.

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

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

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

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

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

curl -X GET 'https://api.irnoti.com/v1/email/contacts?q=%D8%B9%D9%84%DB%8C' \
  -H "Authorization: Bearer $IRNOTI_KEY"

پاسخ نمونه200 OK

[
  {
    "id": "31",
    "name": "علی رضایی",
    "note": null,
    "email": "ali@example.com",
    "phone": "09120000000",
    "groups": [
      "مشتری"
    ],
    "company": "نمونه",
    "isBlocked": false
  }
]