شروع سریع

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

۱. دریافت API Key

پس از فعال‌شدن دسترسی وب‌سرویس، API Key از پنل SMSDaily دریافت می‌شود. کلید را فقط در Backend یا Secret Store نگهداری کنید و آن را داخل JavaScript مرورگر، Repository یا Log قرار ندهید.

۲. Base URL

https://service.smsdaily.ir

نسخه API در مسیر قرار دارد:

/v1/...

۳. ارسال یک پیام

برای هر درخواست ارسال، Idempotency-Key یکتا تعیین کنید. اگر به دلیل Timeout همان درخواست را دوباره تلاش کردید، همان کلید را دوباره ارسال کنید.

curl -X POST "https://service.smsdaily.ir/v1/messages" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Idempotency-Key: 5c88a3d2-65ce-4cc1-9ea0-1d7efe675d40" \
  -H "Content-Type: application/json" \
  -d '{
    "sender": "300099000121",
    "recipient": "09121234567",
    "message": "پیام آزمایشی SMSDaily",
    "clientReference": "order-140501"
  }'

برای پیام جدید پاسخ 202 Accepted دریافت می‌شود:

{
  "trackingCode": "SMS-20260808-A1B2C3D4",
  "status": "queued",
  "encoding": "Persian",
  "characterCount": 23,
  "partCount": 1,
  "submittedAt": "2026-08-08T05:30:00Z",
  "duplicate": false
}

202 Accepted یعنی درخواست پذیرفته شده است؛ این وضعیت به معنی تحویل نهایی پیامک نیست.

اگر همان Idempotency-Key قبلاً برای حساب شما ثبت شده باشد، همان درخواست با 200 OK و duplicate: true برگردانده می‌شود و پیام جدیدی ساخته نمی‌شود.

۴. رهگیری

curl "https://service.smsdaily.ir/v1/messages/SMS-20260808-A1B2C3D4" \
  -H "X-API-Key: YOUR_API_KEY"

وضعیت‌های عمومی شامل queued، processing، sent، delivered، failed و cancelled هستند. کدها و وضعیت‌های اختصاصی Provider در این قرارداد افشا نمی‌شوند.

۵. Correlation ID

تمام پاسخ‌ها Header زیر را دارند:

X-Correlation-Id: 4ac56ce65f3f44fca4370761283a583c

در زمان گزارش خطا به پشتیبانی، این مقدار را همراه trackingCode نگهداری کنید.

۶. مرحله بعد

برای ادامه اتصال، مسیر پیشنهادی این است:

برای Schema رسمی تمام Request/Responseها نیز از مرجع API استفاده کنید.