مستندات رسمی وبسرویس (API v1)
راهنمای جامع توسعهدهندگان مجازی استور
سایت، اپلیکیشن یا ربات تلگرام خود را با بالاترین سرعت و پایداری به قدرتمندترین ارائهدهنده شمارههای مجازی متصل کنید.
نحوه احراز هویت (Authentication)
برای ارسال درخواستها، کلید اختصاصی خود را در هدر X-API-Key یا Authorization: Bearer یا به عنوان پارامتر ?api_key= ارسال نمایید.
X-API-Key: mjz_live_your_secret_api_keyGET
استعلام موجودی کیف پول/api/v1/user/balanceدریافت موجودی حساب کاربری به تومان.
// نمونه پاسخ:
{
"success": true,
"user": {
"id": "cm123456",
"phone": "09123456789",
"balanceToman": 150000,
"formattedBalance": "۱۵۰,۰۰۰ تومان",
"currency": "IRT"
}
}GET
لیست سرویسها/api/v1/servicesدریافت تمامی سرویسهای موجود (تلگرام، واتساپ و...) با کد و ارزانترین قیمت.
GET
استعلام قیمت و موجودی زنده/api/v1/prices?service=tg&country=IDقیمت به تومان و موجودی واقعی سیمکارتهای فعال.
POST
خرید شماره مجازی جدید/api/v1/ordersکسر آنی از کیف پول و تحویل شماره تلفن فعال.
// بدنه درخواست (JSON Request Body):
{
"service": "tg", // کد سرویس تلگرام
"country": "ID" // کد کشور اندونزی (یا کد عددی 6)
}
// نمونه پاسخ موفق (200 OK):
{
"success": true,
"order": {
"id": "cmpxq123456",
"phone": "+62812345678",
"service": { "code": "tg", "name": "تلگرام" },
"country": { "code": "ID", "name": "اندونزی" },
"priceFinalToman": 48000,
"status": "WAITING_SMS",
"expiresAt": "2026-08-31T12:20:00.000Z"
}
}GET
استعلام وضعیت و دریافت کد پیامک/api/v1/orders/{id}دریافت کد SMS تایید شده یا وضعیت زمان باقیمانده.
POST
لغو سفارش و استرداد آنی وجه/api/v1/orders/{id}/cancelلغو سفارش و بازگشت ۱۰۰٪ مبلغ به کیف پول کاربر.