فهرست

ورود | ثبت‌نام
ورود به حسـاب کاربری
بازیابی رمز عبور
آیا حساب کاربـری ندارید؟!
ثبت نام
شماره مجازی

بازار شماره مجازی یکی از بازارهای پرسود و پر رونق است و فضای مناسبی برای کسب درآمد می باشد. شما می توانید با اندک تبلیغات و فعالیتی در این زمینه کسب و کار خود را ساخته و به سودهای قابل توجهی برسید.

در این راستا می توانید از API ما هرگونه نرم افزار، سایت و پنل اینترنتی، نرم افزار موبایل و ...، ربات تلگرام و ... را به پنل نامبری متصل کرده و به صورت کاملا اتوماتیک به فروش شماره مجازی بپردازید.

توضیحات مورد نیاز

توضیحات کلی سیستم نامبری

  1. پنل نامبری شماره مجازی از کشورهای مختلف محدود به سرویس های مختلف ارائه می کند. یعنی هر شماره مختص یک سرویس است، مثلا واتساپ و ...، لیست سرویس ها و کشورهای مختلف در انتهای همین صفحه موجود است.
  2. شماره ها زمان مشخصی بین 10 تا 20 دقیقه دارند. در این زمان می توان از شماره برای سرویس مورد نظر استفاده کرد و هر تعداد پیامک که نیاز است دریافت کرد. بعد از اتمام زمان، بنا به جهات امنیتی و محدودیت های شبکه مخابراتی، شماره آفلاین شده و قابلیت دریافت کد مجدد برای هیچکس را دارا نمی باشد.
  3. پنل نامبری شماره کشورهای مختلف از اپراتورهای مخابراتی مختلف ارائه می کند، در صفحه اصلی سایت جلوی هر کشور یک عدد کوچک قرار گرفته که بیانگر اپراتور مخابراتی است. لیست اپراتورهای مخابراتی در انتهای همین صفحه آمده است.

شیوه کلی کار با API

  1. نرم افزار و یا هر محصولی که مد نظر دارید را برنامه نویسی کرده و با استفاده از کدهای مربوطه به پنل متصل کنید
  2. برای دریافت شماره از پنل، باید حساب شما در پنل شارژ داشته باشد و بعد از دریافت شماره، به همان میزان از شارژ شما کسر میشود
  3. شما قیمت بیشتری برای شماره گذاشته و به مشتری می فروشید، هزینه را از مشتری دریافت می کنید. در واقع شما هزینه شماره را به ما پرداخت می کنید و با قیمت بیشتر به مشتری می فروشید. و در صورتی که فروش نسبتا خوبی داشته باشید از سمت برای خرید شماره تخفیف همکاری خواهید گرفت)

توضیحات فنی

  • هر IP مجاز است هر ثانیه 50 درخواست ارسال کند
    • در صورتی که تعداد درخواست ها از حد مجاز بیشتر شود، درخواست ها توسط سرور رد می شود. و در صورتی که درخواست ها بیش از حد زیاد باشد ip درخواست دهنده برای مدت مشخصی بلاک می شود
    • در صورتی که برنامه شما اصولی نوشته شود به بیش از این مقدار درخواست در ثانیه نیاز پیدا نخواهید کرد
  • در php می توانید از تابع curl یا file_get_contents برای اجرای درخواست ها استفاده کنید.
  • تمامی پاسخ ها در قالب json ارسال می شود.
  • در صورتی که مقدار متغیر  result در پاسخی که دریافت می کنید یک عدد منفی باشد، بیانگر خطا است که در هر قسمت از api توضیح خطاهای مربوطه آمده است

ایرادهای عمومی

RESULT DESCRIPTION توضیـح
-901 apikey not found کلید api اشتباه است
-902 method invalid دستور ارسالی اشتباه است
-990 number id invalid آی دی شماره مورد نظر اشتباه است
-900 دیگر ایرادات فنی - با پشتیبانی تماس بگیرید و مستندات خطا را ارائه دهید

دریافت میزان شارژ حساب کاربری

https://numberi.ir/api/?apikey= [API_CODE]&method=balance

توضیح لینک

موارد رنگی شده را مطابق توضیحات زیر جایگزین کنید

[API_CODE] کلید API دریافت شده از تنظیمات کاربری

نمونه نتیجه درخواست

{
        "RESULT":"1",
        "BALANCE":"192100",
        "CURRENCY":"Toman"
}

مستندات وب سرویس پنل (API)

شماره عادی
شماره دائمی
شماره اجاره‌ای

مراحل و شیوه کار

  1. با استفاده از وب سرویس مربوطه، موجودی و قیمت شماره را بگیرید
    • تمامی شماره های مجازی بر اساس سرویس و کشور و اپراتور دسته بندی شده و موجودی آنها و قیمت هر کدام به شما داده می شود
    • همان قیمت هائی که در حساب کاربری شما نمایش داده می شود نیز در اینجا داده می شود. لذا در صورتی که قیمت ها برای شما تخفیف بخورد در اینجا نیز با تخفیف نمایش داده می شود.
    • می توانید سیستمتان را اینگونه طراحی کنید که به صورت اتوماتیک مبلغی را به قیمت هر شماره اضافه کرده و به مشتری بفروشد.
  2. با استفاده از وب سرویس مربوطه در پائین صفحه، درخواست شماره مجازی بدهید.
    • مشخص می کنید برای چه سرویسی شماره مجازی میخواهید
    • مشخص می کنید از کدام کشور شماره مجازی میخواهید
    • مشخص می کنید از کدام اپراتور مخابراتی شماره میخواهید، همچنین امکان تعیین اتوماتیک اپراتور بر اساس قیمت نیز وجود دارد
    • پس از درخواست، شماره مجازی به شما داده میشود و اطلاعات مورد نیاز داده می شود
      • هزینه شماره مجازی در اینجا از حساب شما کسر می شود. اما توجه داشته باشید در صورتی که شماره را با وب سرویس مربوطه لغو کنید و یا زمان شماره تمام شود و کدی به شما داده نشود هزینه به حساب پنل شما برگشت داده می شود.
      • هر شماره یک آیدی عددی منحصر به فرد دارد که برای ادامه عملیات مورد استفاده قرار میگیرد
      • هر شماره یک تایم مشخص برای دریافت کد دارد که در آن تایم هر تعداد پیامک برای سرویس مربوطه می توانید دریافت کنید و بعد از آن امکان دریافت کد مجدد نیست
  3. با استفاده از وب سرویس مربوطه، وضعیت شماره را بررسی کنید
    • در این مرحله وضعیت شماره را بررسی می کنید، شماره در هر وضعیتی که باشد در اینجا اعلام میشود
    • در صورتی که شماره کد دریافت کرده باشد وضعیت به دریافت کد تغییر کرده و کد نیز نمایش داده می شود
    • در صورتی که زمان استفاده از شماره تمام شده باشد و یا شما آن را کنسل کرده باشید وضعیت مربوطه نمایش داده می شود
    • در صورتی که درخواست کد مجدد داشته باشید، وضعیت در انتظار دریافت کد مجدد نمایش داده میشود
  4. با استفاده از وب سرویس مربوطه وضعیت شماره را تغییر دهید
    • در این مرحله می توانید وضعیت شماره را تغییر دهید
    • می توانید درخواست لغو شماره را در صورتی که کد دریافت نشده است را صادر کنید که شماره لغو شده و هزینه به پنل شما برگشت میخورد
    • می توانید دستور اتمام درخواست را صادر کنید، در صورتی که کد مربوطه را دریافت کرده اید (و اگر هنوز شماره زمان دارد نیازی به کد مجدد ندارید) 
    • می توانید دستور دریافت کد مجدد را صادر کنید(در صورتی که هنوز شماره زمان دارد)
    • بعد از تغییر وضعیت شماره، وضعیت را با وب سرویسی که در بالا توضیح داده شد بررسی کنید و از وضعیتی که ایجاد شده با خبر شوید

دریافت اطلاعات شماره ها

https://numberi.ir/api/?apikey=[API_CODE]&method=getinfo

توضیح پارامترهای لینک

[API_CODE]کلید API دریافت شده از تنظیمات کاربری

پارامترهای اختیاری

می توانید پارامترهای زیر را نیز به لینک اضافه کنید و نتیجه را با ترتیب و فیلترهای مورد نظرتان دریافت کنید.

&operator=[OPERATOR_CODE]

کد اپراتور مخابراتی موجود قسمت لیست اپراتورهای مخابراتی

با افزودن این پارامتر فقط اطلاعات شماره های اپراتور مورد نظر نمایش داده میشود

نکته: می توانید اطلاعات شماره های تمامی اپراتورها را به ترتیب قیمت دریافت کنید، بدین منظور از مقدار  min و any استفاده کنید. توضیحات کامل را در قسمت لیست اپراتورهای مخابراتی مطالعه کنید
&country=[COUNTRY_CODE]

کد کشور موجود در قسمت لیست کشورها

با افزودن این پارامتر فقط اطلاعات شماره های کشور مربوطه نمایش داده می شود
&service=[SERVICE_CODE]

کد سرویس موجود در قسمت لیست سرویس ها

با افزودن این پارامتر، فقط اطلاعات شماره های سرویس مورد نظر نمایش داده می شود

نمونه نتیجه درخواست

{
        "service":"1",
        "country":"8",
        "operator":"1",
        "count":"1087",
        "amount":"1700",
        "repeat":"1",
        "time":"00:20:00",
        "active":1
        "description":"بدون ریپورت"
}
,
...

توضیح نتیجه درخواست

service کد سرویس، موجود در قسمت لیست سرویس ها
country کد کشور، موجود در قسمت لیست کشورها
operator کد اپراتور مخابراتی موجود در قسمت لیست اپراتورهای مخابراتی
count تعداد موجودی شماره
amount قیمت شماره به تومان
repeat قابلیت دریافت پیامک مجدد (درصورتی که مقدار 1 باشد یعنی شماره قابلیت دریافت کد مجدد را داراست)
time مدت زمانی که بعد از گرفتن شماره قادر به دریافت پیامک مجدد هستید
active فعال یا غیر فعال بودن شماره؛ در صورتی که مقدار 1 باشد شماره فعال است و می توانید استفاده کنید، در صورتی که عدد 0 باشد شماره فعال نمی باشد
description توضیحات شماره (مقدار این قسمت برای شماره های بدون ریپورت تلگرام "بدون ریپورت" می باشد.(

گرفتن شماره مجازی

برای دریافت شماره از آدرس زیر استفاده کرده و متغیرهای مشخص شده با رنگ آبی را مطابق توضیحات تنظیم کنید

https://numberi.ir/api/?apikey=[API_CODE]&method=getnum&country=[COUNTRY_CODE]&operator=[OPERATOR_CODE]&service=[SERVICE_CODE]

توضیح پارامترهای لینک

موارد رنگی شده باید متناسب با توضیحات زیر جایگزین شود:

[API_CODE]کلید API دریافت شده از قسمت تنظیمات حساب کاربری
[SERVICE_CODE]کد سرویس مورد نظر؛ از قسمت پیوست ها لیست و کد سرویس ها را مشاهده کنید
[COUNTRY_CODE]کد کشور مورد نظر؛ از قسمت پیوست ها لیست و کد کشورها را مشاهده کنید
[OPERATOR_CODE]کد اپراتور مخابراتی مورد نظر؛ از قسمت پیوست ها مشاهده کنید. همچنین می توانید از مقادیر any و min برای انتخاب اتوماتیک اپراتور مخابراتی بر اساس قیمت استفاده کنید. جهت کسب اطلاعات بیشتر به قسمت مربوطه در پیوست ها در انتهای صفحه مراجعه کنید.

نمونه لینک ایجاد شده

https://numberi.ir/api/?apikey=6e498e434113&method=getnum&country=1&operator=any&service=1

نتیجه درخواست

نتیجه تمام درخواست ها در صورت صحیح بودن درخواست بصورت عبارت json ارسال می گردد مانند نمونه:

{
       "RESULT":"1",
       "ID":"74001",
       "NUMBER":"79313226657",
       "AREACODE":"7",
       "AMOUNT":"2200"
       "REPEAT":"1",
       "TIME":"00:20:00"
}

توضیح نتیجه درخواست

RESULTدر صورت موفق بودن عملیات، مقدار 1 می شود.
IDآیدی اختصاصی شماره خرید شده (آیدی هر شماره را در دیتا ذخیره کنید، جهت انجام عملیات های بعدی مورد نیاز است)
NUMBERشماره مجازی خریداری شده به همراه پیش شماره کشور
AREACODEپیش شماره کشور
AMOUNTقیمت شماره خریداری شده به تومان
REPEATقابلیت دریافت کد مجدد؛ در صورتی که مقدار 1 باشد قابلیت دریافت کد مجدد را دارد
TIMEتایمی که شماره قابلیت دریافت مجدد در آن را دارد (بلافاصله بعد از گرفتن شماره این تایم محاسبه میشود)

ایرادهای احتمالی این بخش

در صورتی که مقدار RESULT عدد 1 نباشد خطائی پیش آمده و ممکن است یکی از مقادیر زیر باشد که خطا و توضیح آن را می توانید مشاهده کنید:

RESULT DESCRIPTION توضیـح
-202 parameters not found مقدار یکی از پارامترها خالی و یا اشتباه است
-204 this number is not active شماره مورد نظر فعال نیست
-205 no balance شارژ شما در پنل کم است
-210 service is not active سرویس مورد نظر فعال نیست
-211 operator is not active اپراتور مخابراتی انتخابی فعال نیست
-212 country is not active کشور انتخابی فعال نیست
ایراد های دیگر که در خود اپراتور ها اتفاق می افتد مشکلی در اپراتور است که فعلا امکان انجام این فعالیت را ندارد باید صبر کنید و بعدا دوباره اقدام نمایید

بررسی وضعیت شماره

https://numberi.ir/api/?apikey=[API_CODE]&method=checkstatus&id=[ID]

توضیح پرامترهای لینک

موارد رنگی شده باید متناسب با توضیحات زیر جایگزین شود:

[API_CODE]کد ای پی آی که از سایت دریافت شده
[ID]همان آی دی شماره مجازی که هنگام خرید شماره دریافت کردید

نمونه نتیجه درخواست

{
       "RESULT":1,
       "CODE":"0",
       "DESCRIPTION":"wait code"
}

توضیح نتیجه درخواست

در صورت صحیح بودن نتیجه، مقدار result بین 1 تا 6 متغیر است که هر کدام از این اعداد بیانگر وضعیت خاصی از شماره است که در این جدول توضیح داده شده است:

RESULT DESCRIPTION توضیـح
1 wait code در انتظار دریافت کد
2 code received

در این حالت کد دریافت شده و در این مقدار نمایش داده میشود:

CODE=""
3 number canceled شماره کنسل شده است
4 number banned شماره مسدود شده است
5 wait code again در انتظار دریافت کد مجدد
6 completed تکمیل درخواست

ایرادهای احتمالی این بخش

RESULT DESCRIPTION توضیـح
-304 number id not fount آیدی شماره یافت نشد

تغییر وضعیت شماره (لغو،مسدود،دریافت کد مجدد،اتمام)

https://numberi.ir/api/?apikey=[API_CODE]&method=[METHOD_NAME]&id=[ID]

توضیح لینک

موارد رنگی شده باید متناسب با توضیحات زیر پر شود

[API_CODE] کلید API دریافت شده از تنظیمات کاربری
[ID] همان آی دی شماره مجازی که هنگام خرید شماره دریافت کردید
[METHOD_NAME] توضیح
cancelnumber

کنسل کردن شماره؛ تنها زمانی می توانید شماره را کنسل کنید که در وضعیت1 (در انتظار دریافت کد) باشد.

در صورت موفق بودن عملیات، هزینه شماره به حساب شما در پنل برگشت میخورد
bannumber

اعلان مسدودی شماره؛ تنها زمانی می توانید شماره را کنسل کنید که در وضعیت1 (در انتظار دریافت کد) باشد.

در صورت موفق بودن عملیات، هزینه شماره به حساب شما در پنل برگشت میخورد
repeat

گرفتن کد مجدد؛ در صورتی می توانید درخواست کد مجدد بدهید که شماره در وضعیت 2 (دریافت موفق کد) باشد.

در صورت موفقیت آمیز بودن درخواست، وضعیت شماره به 5 (در انتظار دریافت کد مجدد) تغییر می کند.
closenumber

تکمیل درخواست و بستن شماره؛ در صورتی که کد را دریافت کردید و درخواست دیگری برای دریافت کد مجدد در تایم باقی مانده ندارید.

این دستور فقط در حالتی عمل می کند که شماره در وضعیت 2 (دریافت موفق کد) یا وضعیت 5 (در انتظار دریافت کد مجدد) باشد.

در صورت موفق آمیز بودن دستور، وضعیت شماره به 6 (تکمیل درخواست) تغییر می کند.

نتیجه درخواست

بعد از اجرا شدن درخواست، دقیقا نتیجه وب سرویس "بررسی وضعیت شماره" نمایش داده میشود و می توانید وضعیت شماره را مطابق توضیحات داده شده در آنجا بررسی کنید و از اجرایی شدن درخواست خود مطمئن شوید

ایرادهای احتمالی این بخش

مشابه ایرادهای بخش چک وضعیت شماره

پیوست ها

لیست کشور ها

برای دریافت لیست کشورها از آدرس زیر استفاده کرده و متغیرهای مشخص شده با رنگ آبی را مطابق توضیحات تنظیم کنید

https://numberi.ir/api/?apikey=[API_CODE]&method=getcountry

توضیح پارامترها

[API_CODE]کلید api اختصاصی شما

نمونه نتیجه درخواست:

[ {
       "id": "1",
       "name": "روسیه",
       "name_en": "Russia",
       "areacode": "7",
       "emoji": "??",
       "image": "./images/cu/ru.png",
       "active": "1"
}, {
       "id": "2",
       "name": "اکراین",
       "name_en": "Ukraine",
       "areacode": "380",
       "emoji": "??",
       "image": "./images/cu/ua.png",
       "active": "1"
} ]

توضیح نتیجه درخواست

idآیدی اختصاصی کشور (همیشه ثابت است)
nameنام فارسی کشور
name_enنام انگلیسی کشور
areacodeپیش شماره کشور
emojiکاراکتر ایموجی پرچم کشور
imageتصویر پرچم کشور
activeفعال یا غیر فعال بودن کشور، در صورت فعال بود وضعیت 1 است.


لیست کشور های موجود در سایت

لیست سرویس ها

برای دریافت لیست سرویس ها از آدرس زیر استفاده کرده و متغیرهای مشخص شده با رنگ آبی را مطابق توضیحات تنظیم کنید

https://numberi.ir/api/?apikey=[API_CODE]&method=getservice

توضیح پارامترها

[API_CODE]کلید api اختصاصی شما

نمونه نتیجه درخواست:

[
	{
		"id":"1",
		"name":"تلگـرام",
		"name_en":"Telegram",
		"description":"شماره‌های بدون ریپورت تلگرام با  نمایش داده شده اند،
با شماره‌های بدون ریپورت می‌توانید به شخصی افراد پیام ارسال کنید، اطلاعات بیشتر قسمت راهنما",
		"image":"./images/sv/telegram.svg",
		"active":1
	},
	{
		"id":"2",
		"name":"اینستاگرام",
		"name_en":"Instagram",
		"description":"",
		"image":"./images/sv/instagram.svg",
		"active":1
	}
]

توضیح نتیجه درخواست

idآیدی اختصاصی سرویس (همیشه ثابت است)
nameنام فارسی سرویس
name_enنام انگلیسی سرویس
descriptionتوضیحات این سرویس
imageتصویر سرویس
activeفعال یا غیر فعال بودن سرویس، در صورت فعال بود وضعیت 1 است.


لیست سرویس های موجود در سایت

لیست اپراتورها

کد اپراتور توضیح
1اپراتور مشخص شده در شماره های داخل پنل با عدد 1
2اپراتور مشخص شده در شماره های داخل پنل با عدد 2
3اپراتور مشخص شده در شماره های داخل پنل با عدد 3
4اپراتور مشخص شده در شماره های داخل پنل با عدد 4
minدر این حالت ارزان ترین شماره در میان اپراتورها به صورت اتوماتیک انتخاب می شود
در صورت عدم موجودی شماره گرانتر انتخاب نمی شود.
مثلا در صورتی که درخواست شماره تلگرام از روسیه را بدهید، سیستم روسیه2 را برای شما انتخاب می کند، حال چه موجودی شماره داشته باشد یا موجودی آن صفر باشد. اما مثلا از یک سرویس یا کشور دیگر درخواست شماره بدهید ممکن است بنا به درخواست شما اپراتور دیگری انتخاب شود.
anyاین گزینه همانند مورد بالا عمل می کند با این تفاوت که در صورت عدم موجودی شماره، اپراتور دیگری را به صورت اتوماتیک برای شما انتخاب می کند که موجودی شماره داشته باشد. ترتیب از قیمت کم به زیاد می باشد.
تمامی حقوق محفوظ است؛ هرگونه کپی برداری پیگرد قانونی دارد.