دریافت استان‌ها

این API به شما امکان دریافت فهرست استان‌های ایران را می‌دهد که می‌تواند برای فیلتر کردن گیرندگان در ارسال شهر و استان از آن‌ها استفاده شود.

📍 لینک دسترسی

GET {base_url}/api/send/banks/provinces

🧾 هدرهای درخواست

کلید	مقدار
Authorization	توکن یا کلید دسترسی
Content-Type	application/json

✅ پاسخ موفق

{
  "data": [
    {
      "id": 89,
      "name": "تهران"
    },
    {
      "id": 90,
      "name": "یزد"
    },
    {
      "id": 91,
      "name": "کرمانشاه"
    },
    {
      "id": 92,
      "name": "اصفهان"
    },
    {
      "id": 93,
      "name": "قزوین"
    },
    {
      "id": 94,
      "name": "آذربایجان شرقی"
    },
    {
      "id": 95,
      "name": "گلستان"
    },
    {
      "id": 96,
      "name": "همدان"
    },
    {
      "id": 97,
      "name": "کرمان"
    },
    {
      "id": 98,
      "name": "خراسان شمالی"
    },
    {
      "id": 99,
      "name": "زنجان"
    },
    {
      "id": 100,
      "name": "لرستان"
    },
    {
      "id": 101,
      "name": "سیستان وبلوچستان"
    },
    {
      "id": 102,
      "name": "البرز"
    },
    {
      "id": 103,
      "name": "سمنان"
    },
    {
      "id": 104,
      "name": "بوشهر"
    },
    {
      "id": 105,
      "name": "کردستان"
    },
    {
      "id": 106,
      "name": "هرمزگان"
    },
    {
      "id": 107,
      "name": "گیلان"
    },
    {
      "id": 108,
      "name": "کهگیلویه وبویراحمد"
    },
    {
      "id": 109,
      "name": "مازندران"
    },
    {
      "id": 110,
      "name": "فارس"
    },
    {
      "id": 111,
      "name": "خوزستان"
    },
    {
      "id": 112,
      "name": "چهارمحال وبختیاری"
    },
    {
      "id": 113,
      "name": "آذربایجان غربی"
    },
    {
      "id": 114,
      "name": "قم"
    },
    {
      "id": 115,
      "name": "اردبیل"
    },
    {
      "id": 116,
      "name": "مرکزی"
    },
    {
      "id": 117,
      "name": "خراسان رضوی"
    },
    {
      "id": 118,
      "name": "ایلام"
    },
    {
      "id": 119,
      "name": "خراسان جنوبی"
    }
  ],
  "meta": {
    "status": true,
    "message": "انجام شد",
    "message_parameters": [],
    "message_code": "200-1"
  }
}

📝 نکات

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

❌ پاسخ خطا — توکن نامعتبر یا منقضی شده (401)

{
  "data": null,
  "meta": {
    "status": false,
    "message": "اطلاعات وارد شده صحیح نمی باشد",
    "message_parameters": [],
    "message_code": "400-1",
    "errors": {}
  }
}

🧪 نمونه درخواست

curl --location '{base_url}/api/send/banks/provinces' \
--header 'Authorization: API TOKEN'