شروع سریع
API Key، Base URL، Idempotency و اولین پیام.
مشاهده راهنما ←مسیر پیشنهادی توسعه
از اولین درخواست تا Production
برای شروع لازم نیست ساختار سرویس‌دهنده‌های داخلی SMSDaily را بدانید؛ فقط با قرارداد عمومی v1 کار می‌کنید.
ارسال و Pattern
ارسال عادی، زمان‌بندی، Batch و الگوهای تاییدشده.
ارسال با الگو ←OTP و خدماتی
OTP با تایید سمت SMSDaily یا Backend مشتری و گروه‌های خدماتی تاییدشده.
راهنمای OTP ←Production
Retry، Rate Limit، Correlation ID، رهگیری و چک‌لیست عملیاتی.
چک‌لیست Production ←Endpointهای اصلی
قرارداد REST عمومی v1
| عملیات | Endpoint | کاربرد |
|---|---|---|
| ارسال پیامک | POST /v1/messages | ارسال عادی با کد پیگیری |
| ارسال Batch | POST /v1/messages/batch | چند پیام متفاوت در یک درخواست |
| زمان‌بندی | POST /v1/messages/scheduled | ثبت پیام برای آینده |
| Pattern | POST /v1/messages/pattern | ارسال با الگوی تاییدشده |
| گروه خدماتی | POST /v1/approved-groups/{groupCode}/messages | متن خدماتی به فهرست تاییدشده |
| OTP مدیریت‌شده | POST /v1/otp/challenges | تولید و اعتبارسنجی OTP سمت SMSDaily |
| OTP سمت مشتری | POST /v1/otp/codes | تولید OTP و بازگرداندن کد به Backend مشتری |
| رهگیری | GET /v1/messages/{trackingCode} | وضعیت و تاریخچه عمومی پیام |
| پیام ورودی | GET /v1/inbound-messages | دریافت پیام‌های ورودی حساب |
نمونه REST
یک درخواست ساده و قابل Retry
POST https://service.smsdaily.ir/v1/messages
X-API-Key: YOUR_API_KEY
Idempotency-Key: order-1405-1001
Content-Type: application/json
{
"sender": "300099000121",
"recipient": "09121234567",
"message": "سفارش شما آماده تحویل است.",
"clientReference": "order-1001"
}
202 Accepted
{
"trackingCode": "SMS-20260810-A1B2C3D4",
"status": "queued",
"encoding": "Persian",
"characterCount": 29,
"partCount": 1,
"duplicate": false
}در Retry شبکه همان Idempotency-Key را دوباره ارسال کنید. 202 Accepted به معنی پذیرش درخواست است، نه تحویل نهایی به گوشی.
نمونه‌کد آماده
شروع سریع با فناوری فعلی شما
C# / .NET
نمونه HttpClient و JsonContent برای پروژه‌های ASP.NET Core و Blazor Backend.
PHP و Python
نمونه درخواست قابل کپی برای Backendهای متداول.
Node.js و Java
نمونه Server-to-Server با همان قرارداد REST.
مستقیم وارد مستندات توسعه‌دهندگان شوید
برای پیاده‌سازی جدید، مرجع رسمی شما docs.smsdaily.ir و قرارداد عمومی service.smsdaily.ir است.