وب سرویس پیامکی (API)؛ سریع، امن و توسعه‌دهنده محور

مستندات وب سرویس REST API

آدرس پایه: https://api.free-sms.ir/v1

نمونه کدهای برنامه‌نویسی

نمونه‌ی زیر یک پیامک ساده با پایتون ارسال می‌کند. برای PHP، Node.js و C# نیز الگو مشابه است.

# نصب: pip install requests
import requests

url = "https://api.free-sms.ir/v1/send"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
    "line": "5000xxxxxx",
    "to": ["09121234567"],
    "text": "سفارش شما ثبت شد."
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

ارسال پیامک OTP (اعتبارسنجی)

برای ورود دومرحله‌ای یا تایید شماره موبایل، از اندپوینت اختصاصی /otp استفاده کنید. این مسیر به دلیل استفاده از خط خدماتی، خارج از محدودیت بلک‌لیست است و میانگین زمان تحویل آن زیر ۲ ثانیه است.

import requests

url = "https://api.free-sms.ir/v1/otp"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {"to": "09121234567", "template": "login_otp"}

response = requests.post(url, headers=headers, json=payload)
print(response.json())  # {'status': 'sent', 'expires_in': 120}