SMS Rooms — Virtual Numbers for SMS Verification

وثائق API

الرئيسيةAPI

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

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

يتطلب الوصول إلى API إيداع ما لا يقل عن 10 دولارات في الحساب إجمالاً. يُحتسب مجموع الإيداعات طوال عمر الحساب، وليس الرصيد الحالي. وبمجرد بلوغ هذا الحد يبقى الوصول متاحاً بغض النظر عن تغيّرات الرصيد. أما الطلبات دون هذا الحد فتُرجع NO_BALANCE:MIN_DEPOSIT_10.

عنوان طلب 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 — اسم خدمة غير صحيح