API التحقق عبر SMS

تعالج شراء الأرقام والتحقق من الرموز والإلغاء بطلب HTTP واحد. نستخدم أسلوب handler_api الشائع في مجال الأرقام الافتراضية، فيكفي إدخال العنوان والمفتاح في برامج التسجيل والبوتات ليتم الربط فورًا.

احصل على مفتاح API

بعد تسجيل الدخول أنشئ مفتاحًا من قائمة API في صفحة الحساب. يظهر المفتاح مرة واحدة فقط عند إنشائه، فاحفظه فورًا. تستخدم API الرصيد نفسه والأسعار نفسها التي يستخدمها الموقع.

العنوان الأساسي

https://nuviosms.com/stubs/handler_api.php?api_key=API_KEY&action=...

الطلبات الرئيسية

actionما نقدمهمثال على الاستجابة
getBalanceالاستعلام عن الرصيدACCESS_BALANCE:12.50
getPrices&service=telegram&country=gbالأسعار والأرقام المتاحة حسب الخدمة والدولة{"gb":{"telegram":{"cost":0.207,"count":8877728}}}
getNumber&service=telegram&country=gbشراء رقمACCESS_NUMBER:ID:PHONE
getStatus&id=IDالتحقق من الرمزSTATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8إلغاء الرقم (قبل وصول الرمز، استرداد كامل)ACCESS_CANCEL
setStatus&id=ID&status=3استلام رمز إضافي على الرقم نفسهACCESS_RETRY_GET
setStatus&id=ID&status=6إنهاء الاستخدامACCESS_ACTIVATION

عناصر الطلب

الاسمإلزاميالوصف
api_keyالكلمفتاح API المنشأ في صفحة الحساب
actionالكلgetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberرمز الخدمة (مثال: telegram، whatsapp، google). مطابق لعنوان صفحة قائمة الخدمات
countrygetNumberرمز الدولة من حرفين (مثال: gb، us، id)
idgetStatus, setStatusمعرّف الرقم الذي أعاده getNumber (يبدأ بـ N-)
statussetStatus8 إلغاء، 3 رمز إضافي، 6 إنهاء، 1 جاهز

نص الاستجابة ومعناه

الاستجابةالمعنىالمال
ACCESS_NUMBER:ID:PHONEتم استلام الرقميُخصم سعر الرقم
STATUS_WAIT_CODEفي انتظار الرمزكما هو
STATUS_OK:CODEوصل الرمزتم الدفع
STATUS_WAIT_RETRY:CODEفي انتظار الرمز التالي (مع الرمز السابق)دون رسوم إضافية
STATUS_CANCELأُلغي أو انتهى الوقتتم الاسترداد إذا لم يصل رمز
ACCESS_CANCELتم الإلغاءاسترداد كامل
ACCESS_RETRY_GETانتظار رمز إضافي على الرقم نفسهدون رسوم إضافية
ACCESS_ACTIVATIONانتهى استخدام الرقمكما هو
NO_BALANCEاشحن رصيدك واستلم فورًالا يُخصم
NO_NUMBERSلا تتوفر أرقام لتلك الدولة حاليًالا يُخصم
NO_ACTIVATIONSلديك 20 رقمًا مفتوحًالا يُخصم
EARLY_CANCEL_DENIEDللرقم الذي وصله رمز استخدم الإنهاء (6) بدلًا من الإلغاءكما هو
BAD_KEYمفتاح API غير صحيحلا يُخصم
BAD_SERVICE / BAD_COUNTRYرمز الخدمة أو الدولة غير صحيحلا يُخصم
NO_ACTIVATIONلم يتم العثور على معرّف الرقمكما هو
TOO_MANY_REQUESTSتجاوزت 300 طلب في الدقيقةلا يُخصم

أمثلة حسب اللغة

import time, requests

BASE = "https://nuviosms.com/stubs/handler_api.php"
KEY = "API_KEY"

def call(**p):
    return requests.get(BASE, params={"api_key": KEY, **p}, timeout=30).text

r = call(action="getNumber", service="telegram", country="gb")
if not r.startswith("ACCESS_NUMBER"):
    raise SystemExit(r)
_, num_id, phone = r.split(":")
print("Number:", phone)

for _ in range(240):                      # 20 minutes
    s = call(action="getStatus", id=num_id)
    if s.startswith("STATUS_OK"):
        print("Code:", s.split(":")[1])
        call(action="setStatus", id=num_id, status=6)
        break
    time.sleep(5)

طريقة الاستخدام

  • احصل على رقم عبر getNumber، وأدخله في صفحة التسجيل، ثم استدعِ getStatus كل 5 ثوانٍ.
  • STATUS_OK:عند وصول الرمز أدخله ثم أنهِ بـ setStatus 6.
  • إذا لم يصل الرمز خلال 20 دقيقة يُسترد سعر الرقم تلقائيًا إلى رصيدك.
  • أرسل حتى 300 طلب في الدقيقة.