راهنمای درخواست برقراری تک‌زنگ (Call API)

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

---

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

https://gateway.ferzz.ir/

---

🔐 احراز هویت

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

"token": "Your access token"

---

🚀 Endpoint: ارسال درخواست تماس (ارسال کد)

POST /send

درخواستی برای برقراری تماس به شماره کاربر با کد ارسالی حداکثر 5 رقمی.

Headers

Key	Value
Content-Type	application/json

Request Body

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

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

Success Response

{
  "message": "درخواست با موفقیت ارسال شد.",
  "status": 200,
  "track_id": "cdd18c14-5ef8-407a-b2b0-d08877a718a7"
}

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

Error Responses

Status	Message (EN)	Message (FA)	Example Codes
400	Invalid input	ورودی نامعتبر	D01, D02, D03, D04, D05, D06, D07
403	Access denied / Token unusable	دسترسی غیرمجاز / توکن قابل استفاده نیست	T02, T03, P01
404	Token not found	توکن یافت نشد	T01
409	Token quota exhausted	سهمیه توکن به پایان رسیده	T05
422	Message could not be sent	ارسال پیام با خطا مواجه شد	N01, N02, N03
429	Too many requests	درخواست‌های بیش‌ازحد	(Rate limiter, custom)
500	Internal server error	خطای داخلی سرور	P02, P03

---

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

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