محاسبه هزینه پیامک

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

📍 لینک دسترسی

POST {base_url}/api/send/calculate-price

🧾 هدرها

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

📤 بدنه درخواست

{
  "number": "+983000505",
  "message": "تست"
}

📝 پارامترها

پارامتر	نوع	ضروری	توضیحات
number	string	بله	سرشماره ای که میخواهید با آن ارسال را انجام دهید در فرمت E.164 (مثال: +983000505)
message	string	بله	متن پیامی که میخواهید ارسال نمایید. این متن نباید بیش از 1400 کارکتر یا 20 پارت باشد

📝 نکات

• هزینه بر اساس طول پیام و سرشماره نورد نظر جهت ارسال محاسبه می‌شود.
• پیام‌های طولانی به چندین قسمت تقسیم می‌شوند که هر قسمت هزینه جداگانه‌ای دارد.
• قیمت‌ها برحسب ریال ارائه می‌شوند.
• در این محاسبه کلمه لغو11 (شش کارکتر) محاسبه نمیشود، اگر میخواهید در محاسیات لحاظ گردد باید متن را به همراه لغو11 برای محاسبه ارسال نمایید

✅ پاسخ موفق

{
  "data": {
    "mci_price": 2370,
    "other_price": 2503,
    "parts": 1
  },
  "meta": {
    "status": true,
    "message": "calculate successfully",
    "message_parameters": [],
    "message_code": "200-1"
  }
}

توضیح فیلدهای پاسخ

فیلد	توضیحات
mci_price	هزینه ارسال به شبکه همراه اول (برحسب ریال)
other_price	هزینه ارسال به سایر شبکه‌ها (برحسب ریال)
parts	تعداد قسمت‌هایی که پیام به آن‌ها تقسیم می‌شود

❌ پاسخ خطا — درخواست نامعتبر (422)

{
  "data": null,
  "meta": {
    "status": false,
    "message": "تکمیل گزینه پیام الزامی است",
    "message_parameters": [],
    "message_code": "400-2",
    "errors": {
      "message": [
        "تکمیل گزینه پیام الزامی است"
      ]
    }
  }
}

🧪 مثال درخواست

curl --location '{base_url}/api/send/calculate-price' \
--header 'Content-Type: application/json' \
--header 'Authorization: API TOKEN' \
--data '{
    "number": "+983000505",
    "message": "تست"
}'