تلفن تماس:

09103945604

ثبت نام/ ورود
ارسال پیام انبوه
API

مستندات SimDirect

تمام درخواست‌ها باید پارامترهای api_key و method را شامل شوند. برای دریافت API Key به @SimDirectbot مراجعه کنید.

🚀

شروع سریع

  1. دریافت API Key از ربات @SimDirectbot
  2. فراخوانی getcountry و getservice برای دریافت countryId و serviceId
  3. درخواست getnum برای دریافت شماره → ذخیره requestId
  4. پیگیری با checkstatus تا وضعیت success و دریافت کد
  5. در صورت نیاز، لغو با cancelNumber
همه درخواست‌ها GET هستند و پارامترها در Query ارسال می‌شوند.
GET

دریافت کشورها (getcountry)

{{url}}?api_key=YOUR_KEY&method=getcountry

لیست کشورهایی که برای دریافت شماره مجازی پشتیبانی می‌شوند.

پارامترها

پارامتر
نوع
ضروری
توضیح
api_key
string
بله
کلید API شما
method
string
بله
مقدار ثابت: getcountry

پاسخ نمونه

{
  "data": [
    { "ID": 1, "name": "فیلیپین", "code": "+1" },
    { "ID": 2, "name": "ترکیه", "code": "+2" },
    { "ID": 3, "name": "روسیه🌟", "code": "+3" },
    { "ID": 4, "name": "ویتنام", "code": "+4" },
    { "ID": 5, "name": "هند🌟", "code": "+5" },
    { "ID": 6, "name": "قرقیزستان", "code": "+6" },
    { "ID": 7, "name": "اوکراین", "code": "+88" },
    { "ID": 8, "name": "ایران", "code": "+98" }
  ],
  "message": "getCountries"
}
GET

دریافت سرویس‌ها (getservice)

{{url}}?api_key=YOUR_KEY&method=getservice

اپلیکیشن‌های پشتیبانی شده برای دریافت شماره مجازی.

پاسخ نمونه

{
  "data": [
    { "ID": 1, "name": "تلگرام" },
    { "ID": 2, "name": "اینستاگرام" },
    { "ID": 3, "name": "یوتیوب" },
    { "ID": 4, "name": "واتساپ" },
    { "ID": 5, "name": "فیسبوک" },
    { "ID": 10, "name": "وایبر" },
    { "ID": 16, "name": "استیم" }
  ],
  "message": "getApps"
}
GET

موجودی حساب (getbalance)

{{url}}?api_key=YOUR_KEY&method=getbalance

پاسخ نمونه

{
  "data": 99616,
  "message": "getUserBalance"
}
GET

دریافت شماره (getnum)

{{url}}?api_key=YOUR_KEY&method=getnum&serviceId=1&countryId=1

برای دریافت شماره، شناسهٔ برنامه و کشور الزامی است. خروجی شامل requestId خواهد بود.

پارامترها

پارامتر
نوع
ضروری
توضیح
serviceId
integer
بله
شناسه اپ (از getservice)
countryId
integer
بله
شناسه کشور (از getcountry)
پس از دریافت شماره، requestId را ذخیره کنید تا با checkstatus وضعیت/کد را بگیرید.

پاسخ نمونه

{
  "data": {
    "requestId": 774502450,
    "number": "+90 5xx xxx xx xx",
    "expires_in": 900
  },
  "message": "newNumber"
}
GET

وضعیت شماره (checkstatus)

{{url}}?api_key=YOUR_KEY&method=checkstatus&requestId=774502450

وضعیت‌های ممکن

cancelled — لغو شده (بازگشت هزینه)
waiting — در انتظار دریافت کد
success — کد دریافت شده

پاسخ نمونه (success)

{
  "data": {
    "status": "success",
    "code": "12345",
    "received_at": "2025-09-28T12:00:14Z"
  },
  "message": "checkStatus"
}

پاسخ نمونه (waiting)

{
  "data": { "status": "waiting" },
  "message": "checkStatus"
}
GET

لغو شماره (cancelNumber)

{{url}}/cancelNumber?api_key=YOUR_KEY&requestId=1
لغو شماره غیرقابل بازگشت است؛ اما مبلغ به موجودی شما بازگردانده می‌شود.

پاسخ نمونه

{
  "data": { "status": "cancelled", "requestId": 774502450, "refund": 1200 },
  "message": "cancelNumber"
}
GET

شماره اختصاصی تلگرام (getDedicatedTelegramNumber)

{{url}}?api_key=YOUR_KEY&method=getDedicatedTelegramNumber&type=reported&countryId=1

پارامترها

پارامتر
نوع
ضروری
توضیح
type
string
بله
reported یا not_reported
countryId
integer
بله
شناسه کشور
reported: اقتصادی‌تر، احتمال محدودیت بیشتر
not_reported: گران‌تر ولی مطمئن‌تر

پاسخ نمونه

{
  "data": {
    "requestId": 84,
    "number": "+90 5xx xxx xx xx",
    "type": "reported"
  },
  "message": "getDedicatedTelegramNumber"
}
GET

دریافت کد اختصاصی تلگرام (getDedicatedTelegramStatus)

{{url}}?api_key=YOUR_KEY&requestId=84&method=getDedicatedTelegramStatus

با استفاده از requestId کد ارسال‌شده به شماره اختصاصی را دریافت کنید.

پاسخ نمونه

{
  "data": {
    "status": "success",
    "code": "54321",
    "received_at": "2025-09-28T12:03:27Z"
  },
  "message": "getDedicatedTelegramStatus"
}
☎️

پشتیبانی

کپی شد