API ارسال پیامک
API پیامک بازارپی: ارسال پیامک ساده، پیامک الگو و رمز یکبار مصرف (OTP) با گزارش وضعیت تحویل و محاسبه به ازای هر بخش پیامک.
سرویس‌های پیامک بازارپی سه نیاز رایج کسب‌وکارها را پوشش می‌دهند: «ارسال پیامک ساده» به یک یا چند گیرنده، «ارسال پیامک الگو» بر اساس الگوی تأییدشده، و «ارسال رمز یکبار مصرف» برای ورود و تأیید کاربران. وضعیت تحویل پیامک‌ها هم قابل استعلام است.
هزینه پیامک به ازای هر بخش و هر گیرنده محاسبه می‌شود: پیامک فارسی تا ۷۰ نویسه یک بخش است (در پیامک چندبخشی هر بخش ۶۷ نویسه) و پیامک لاتین تا ۱۶۰ نویسه (چندبخشی ۱۵۳). پیامکهایی که از حساب شما ارسال می‌شوند متعلق به حساب شما هستند و استعلام وضعیتشان فقط برای خودتان پاسخ داده می‌شود.
برای استفاده، در بازارپی ثبت‌نام کنید، سرویس را درخواست دهید و پس از تأیید، کلید API بسازید. یک جفت کلید برای همه سرویس‌ها کار می‌کند، دسترسی هر کلید را می‌توانید به IP سرورهای خود محدود کنید و با «کلید تست» پاسخ نمونه بدون کسر هزینه بگیرید. هزینه به ریال و فقط برای درخواست‌های موفق از کیف پول (پیش‌پرداخت) یا سقف اعتبار (پس‌پرداخت) کسر می‌شود؛ خطاهای سمت ارائه‌دهنده (۵xx) هرگز محاسبه نمی‌شوند.
کاربردها
- ارسال رمز یکبار مصرف برای ورود یا تأیید تراکنش
- اطلاع‌رسانی وضعیت سفارش با پیامک الگو
- ارسال پیامک به فهرستی از گیرندگان
- پیگیری وضعیت تحویل پیامک‌های ارسال‌شده
سرویس‌ها و قیمت
جزئیات کامل درخواست و پاسخ در مرجع API و نحوه دریافت توکن در راهنمای فنی آمده است.
سؤالات متداول
هزینه پیامک چطور محاسبه می‌شود؟
به ازای هر بخش (segment) و هر گیرنده. پیامک فارسی تا ۷۰ نویسه و لاتین تا ۱۶۰ نویسه یک بخش است و مبنای نهایی مقدار segment_count در پاسخ ارائه‌دهنده است.
تفاوت پیامک ساده، الگو و OTP چیست؟
پیامک ساده متن آزاد به یک یا چند گیرنده است، پیامک الگو بر اساس الگوی تأییدشده ارسال می‌شود و OTP برای ارسال رمز یکبار مصرف است. هر کدام سرویس و قیمت جداگانه دارد.
آیا وضعیت تحویل پیامک را میتوان دید؟
بله، وضعیت پیامکهایی که از حساب خودتان ارسال شده قابل استعلام است.
اگر قبلاً با API استاندارد این سرویس کار کردهام چه تغییری لازم است؟
مسیرها، بدنه درخواست و پاسخها مطابق ساختار استاندارد رایج است؛ کافی است آدرس پایه و کلید API را به بازارپی تغییر دهید.