REST API عمومی SMSDaily روی service.smsdaily.ir ارائه می‌شود؛ مستندات کامل در docs.smsdaily.ir در دسترس است.

Public REST API v1

یک قرارداد عمومی؛ مسیریابی داخلی بر اساس شماره فرستنده

Backend مشتری همیشه با قرارداد ثابت SMSDaily کار می‌کند. انتخاب مسیر مناسب برای خط ۳۰۰۰، خطوط ثابت و سایر سرویس‌دهنده‌ها در داخل سامانه انجام می‌شود و جزئیات Provider در API عمومی افشا نمی‌شود.

قابلیت‌های عمومی

عملیات موردنیاز یک Backend واقعی

1

ارسال فوری

ارسال عادی با Sender، Recipient، متن و Client Reference.

N

Batch

چند پیام متفاوت در یک درخواست با Tracking Code مستقل.

◷

زمان‌بندی

ثبت پیام برای ارسال در تاریخ و ساعت آینده.

UID

Pattern

الگوی تاییدشده و متغیرهای کنترل‌شده برای پیام خدماتی.

OTP

OTP

تایید سمت SMSDaily یا تولید کد برای اعتبارسنجی Backend مشتری.

G

گروه خدماتی

ارسال متن آزاد به فهرست مخاطبانی که قبلاً تایید شده‌اند.

✓

رهگیری

وضعیت عمومی، تاریخچه، استعلام تکی و گروهی.

↙

پیام ورودی

دریافت پیام‌های ورودی قابل دسترس حساب با Pagination.

نمونه REST

ارسال پیام با قرارداد فعلی

POST https://service.smsdaily.ir/v1/messages
X-API-Key: YOUR_API_KEY
Idempotency-Key: invoice-1405-1001
Content-Type: application/json

{
  "sender": "02170001234",
  "recipient": "09121234567",
  "message": "یادآوری: موعد پرداخت شما فردا است.",
  "clientReference": "invoice-1001"
}

202 Accepted
{
  "trackingCode": "SMS-20260810-A1B2C3D4",
  "status": "queued",
  "encoding": "Persian",
  "characterCount": 36,
  "partCount": 1,
  "duplicate": false
}
شماره فرستنده بخشی از درخواست مشتری است؛ SMSDaily براساس Sender مسیر داخلی سازگار را انتخاب می‌کند. نام، آدرس و Credential سرویس‌دهنده پایین‌دستی در پاسخ عمومی نمایش داده نمی‌شود.

پایداری

برای Retry و رهگیری از ابتدا طراحی شده

ارسال امنIdempotency

Retry شبکه با همان کلید نباید پیام تکراری ایجاد کند.

پشتیبانیCorrelation ID

هر درخواست یک شناسه برای عیب‌یابی و پیگیری فنی دارد.

رهگیریTracking Code

شناسه عمومی مستقل از شناسه‌های Provider است.

پایداریRate Limit & Backoff

برای 429 و خطاهای موقت، Retry کنترل‌شده انجام می‌شود.

راهنمای فنی

مستندات مستقل برای برنامه‌نویس

پورتال docs شامل جدول Request/Response، نمونه C#/.NET، PHP، Python، Node.js و Java و مرجع OpenAPI است.

راهنماهای سناریویی

Pattern، OTP، گروه خدماتی، Batch و زمان‌بندی با مثال عملی.

فهرست Endpointها ←

اتصال را با مستندات رسمی شروع کنید

Base URL عمومی: https://service.smsdaily.ir