SMS Rooms — Virtual Numbers for SMS Verification

وثائق API

الرئيسيةAPI

تُدعم طلبات POST وGET.

يجب تمرير مفتاح API كمعطى api_key

عنوان طلب API: https://sms-rooms.com/stubs/handler_api.php

الحصول على رقم

الطلب:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&country=$country&ref=$ref&maxPrice=$maxPrice

المعطيات:

$api_keyمفتاح API
$serviceالخدمة المطلوب طلبها
$countryدولة الرقم
$refمعرّف الحساب(اختياري)
$maxPriceالحد الأقصى للسعر(اختياري)

الاستجابة:

ACCESS_NUMBER:$activationId:$phoneNumber

مثال طلب:

https://sms-rooms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=tg&country=187&maxPrice=5

الاستجابة::

ACCESS_NUMBER:2887:17744056708

الأخطاء:

BAD_KEY — مفتاح API غير صالح
BAD_ACTION — إجراء غير صحيح
BAD_SERVICE — اسم خدمة غير صحيح
BAD_COUNTRY — اسم دولة غير صحيح
NO_BALANCE — رصيد غير كافٍ
NO_NUMBERS — لا أرقام متاحة

فحص حالة التفعيل

الطلب:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id

المعطيات:

$api_keyمفتاح API
$idمعرّف التفعيل من getNumber

الاستجابة:

STATUS_OK:'رمز SMS' أو STATUS_WAIT_CODE

الأخطاء:

BAD_KEY — مفتاح API غير صالح
BAD_ACTION — إجراء غير صحيح
NO_ACTIVATION — معرّف تفعيل غير موجود

فحص الرصيد

الطلب:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getBalance

المعطيات:

$api_keyمفتاح API

الاستجابة:

ACCESS_BALANCE:'رصيد الحساب'

الأخطاء:

BAD_KEY — مفتاح API غير صالح
BAD_ACTION — إجراء غير صحيح

تغيير حالة التفعيل

الطلب:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id

المعطيات:

$api_keyمفتاح API
$idمعرّف التفعيل
$statusالحالة: 1 جاهز، 3 إعادة طلب، 6 إكمال، 8 إلغاء

الاستجابة:

ACCESS_READY / ACCESS_ACTIVATION / ACCESS_CANCEL / ACCESS_RETRY_GET

مثال طلب:

https://sms-rooms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=setStatus&status=3&id=2887

الاستجابة::

ACCESS_RETRY_GET

الأخطاء:

BAD_KEY — مفتاح API غير صالح
BAD_ACTION — إجراء غير صحيح
NO_ACTIVATION — معرّف تفعيل غير موجود
BAD_STATUS — حالة غير صحيحة

قائمة الخدمات

الطلب:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getServicesList

المعطيات:

$api_keyمفتاح API

الاستجابة:

{"code": "معرّف الخدمة", "name": "اسم الخدمة"}

الأخطاء:

BAD_KEY — مفتاح API غير صالح
BAD_ACTION — إجراء غير صحيح

قائمة الدول

الطلب:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getCountries

المعطيات:

$api_keyمفتاح API

الاستجابة:

{"id": "معرّف الدولة", "rus": "الاسم بالروسية", "eng": "الاسم بالإنجليزية"}

الأخطاء:

BAD_KEY — مفتاح API غير صالح
BAD_ACTION — إجراء غير صحيح

عدد الأرقام

الطلب:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country

المعطيات:

$api_keyمفتاح API
$countryدولة الرقم

الاستجابة:

{"service_code": "numbers_count"}

الأخطاء:

BAD_KEY — مفتاح API غير صالح
BAD_ACTION — إجراء غير صحيح
BAD_COUNTRY — اسم دولة غير صحيح

قائمة الأسعار

الطلب:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getPrices&service=$service&country=$country

المعطيات:

$api_keyمفتاح API
$serviceالخدمة المطلوب طلبها(اختياري)
$countryدولة الرقم(اختياري)

الاستجابة:

{"رمز الدولة": {"رمز الخدمة": {"السعر": العدد}}}

الأخطاء:

BAD_KEY — مفتاح API غير صالح
BAD_ACTION — إجراء غير صحيح
BAD_COUNTRY — اسم دولة غير صحيح
BAD_SERVICE — اسم خدمة غير صحيح