ارسال کد احراز هویت (OTP) از طریق پیامک

📡 ارسال OTP با پیامک بین‌الملل

برای ارسال OTP از طریق سرویس پیامک بین‌الملل، نیاز است که درخواستی از نوع POST به آدرس URL مشخص شده زده شود. در ادامه، جزئیات این درخواست و پاسخ آن شرح داده شده است.

---

🌐 آدرس درخواست - Base URL

https://gateway.ferzz.ir/

---

🔐 احراز هویت

برای استفاده از API باید token مخصوص سرویس خود را در بدنه درخواست ارسال کنید:

"token": "Your access token"

---

🚀 Endpoint

Method	Endpoint
POST	/send

📝 Headers

Key	Value
Content-Type	application/json

---

📦 Request Body

{
  "destination": "989123456789",
  "token": "Your access token",
  "action": "sms",
  "payload": {
    "code": "05043"
  }
}

توضیحات فیلدها

فیلد	نوع	اجباری	توضیح
destination	string	✅	شماره موبایل کاربر با کد کشور
code	string	✅	کد احراز هویت کاربر
token	string	✅	کلید دسترسی سرویس
action	string	✅	نوع ارسال کد

---

✅ پاسخ موفق (Success Response)

{
  "message": "پیام با موفقیت انجام شد.",
  "status": 200,
  "track_id": "bcfb18ef-7846-4d1a-beb2-9e412c11541f",
  "error": null
}

توضیحات پاسخ موفق

فیلد	نوع	اجباری	توضیح
message	string	✅	متن نتیجه
status	number	✅	کد نتیجه
track_id	string	✅	کد پیگیری درخواست
error	string	✅	متن و کد، در صورت خطا

---

❌ پاسخ خطا (Error Responses)

{
  "message": "کلید دسترسی وجود ندارد.",
  "status": 401,
  "track_id": "",
  "error": {
    "code": "S02T01",
    "detail": "Token is missing."
  }
}

توضیحات خطاها

Code	Detail
S02T01	Token is missing.
S02T02	Token is not usable.
S02D01	Token is missing.
S02D02	Phone number format is invalid.
S02D03	Code is not valid.
S02N01	Network error.

---

📌 نمونه درخواست با curl

curl -X POST https://gateway.ferzz.ir/send \
  -H "Content-Type: application/json" \
  -d '{
    "destination": "989123456789",
    "token": "YOUR_ACCESS_TOKEN",
    "action": "sms",
    "payload": {
      "code": "12345"
    }
  }'

---