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

فیلترهای بانک

مقادیر قابل‌انتخاب (اپراتور، استان، شهر، برچسب) و شمارش هر کدام.

GEThttps://api.irnoti.com/v1/number-banks/{id}/facets
scope: sms.read

برای ساخت فیلتر POST /number-banks/quote|send استفاده می‌شود.

پارامترها

ناممحلنوعتوضیح
id *مسیرstringشناسهٔ بانک.

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

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

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

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

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

curl -X GET 'https://api.irnoti.com/v1/number-banks/3/facets' \
  -H "Authorization: Bearer $IRNOTI_KEY"
پاسخ نمونه200 OK
{
  "tags": [],
  "cities": [],
  "operators": [
    {
      "key": "mci",
      "count": 21000
    }
  ],
  "provinces": [
    {
      "key": "تهران",
      "count": 30100
    }
  ]
}
فیلترهای بانک — مستندات API | ایران ناتیفیکیشن