SMS Rooms — Virtual Numbers for SMS Verification

Documentación de la API

InicioAPI

Se admiten peticiones POST y GET.

Las peticiones deben incluir la clave API como parámetro api_key

El acceso a la API requiere un depósito total de al menos 10 $ en la cuenta. Se tiene en cuenta la suma acumulada de todos los depósitos durante toda la vida de la cuenta, no el saldo actual. Una vez alcanzado el umbral, el acceso se mantiene independientemente de los cambios del saldo. Por debajo de ese umbral, las peticiones devuelven NO_BALANCE:MIN_DEPOSIT_10.

Dirección de la petición API: https://sms-rooms.com/stubs/handler_api.php

Obtener número

Petición:

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

Parámetros:

$api_keyTu clave API
$serviceServicio a pedir
$countryPaís del número
$refID de cuenta(opcional)
$maxPricePrecio máximo(opcional)

Respuesta:

ACCESS_NUMBER:$activationId:$phoneNumber

Ejemplo de petición:

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

Respuesta::

ACCESS_NUMBER:2887:17744056708

Errores:

BAD_KEY — clave API no válida
BAD_ACTION — acción incorrecta
BAD_SERVICE — nombre de servicio incorrecto
BAD_COUNTRY — nombre de país incorrecto
NO_BALANCE — saldo insuficiente
NO_NUMBERS — no hay números disponibles

Comprobar estado de la activación

Petición:

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

Parámetros:

$api_keyTu clave API
$idID de activación recibido en getNumber

Respuesta:

STATUS_OK:'Código SMS' o STATUS_WAIT_CODE

Errores:

BAD_KEY — clave API no válida
BAD_ACTION — acción incorrecta
NO_ACTIVATION — el ID de activación no existe

Comprobar saldo

Petición:

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

Parámetros:

$api_keyTu clave API

Respuesta:

ACCESS_BALANCE:'Saldo de la cuenta'

Errores:

BAD_KEY — clave API no válida
BAD_ACTION — acción incorrecta

Cambiar estado de la activación

Petición:

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

Parámetros:

$api_keyTu clave API
$idID de activación
$statusEstado: 1-listo, 3-solicitar de nuevo, 6-completar, 8-cancelar

Respuesta:

ACCESS_READY / ACCESS_ACTIVATION / ACCESS_CANCEL / ACCESS_RETRY_GET

Ejemplo de petición:

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

Respuesta::

ACCESS_RETRY_GET

Errores:

BAD_KEY — clave API no válida
BAD_ACTION — acción incorrecta
NO_ACTIVATION — el ID de activación no existe
BAD_STATUS — estado incorrecto

Lista de servicios

Petición:

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

Parámetros:

$api_keyTu clave API

Respuesta:

{"code": "ID del servicio", "name": "Nombre del servicio"}

Errores:

BAD_KEY — clave API no válida
BAD_ACTION — acción incorrecta

Lista de países

Petición:

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

Parámetros:

$api_keyTu clave API

Respuesta:

{"id": "ID de país", "rus": "Nombre en ruso", "eng": "Nombre en inglés"}

Errores:

BAD_KEY — clave API no válida
BAD_ACTION — acción incorrecta

Recuento de números

Petición:

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

Parámetros:

$api_keyTu clave API
$countryPaís del número

Respuesta:

{"service_code": "numbers_count"}

Errores:

BAD_KEY — clave API no válida
BAD_ACTION — acción incorrecta
BAD_COUNTRY — nombre de país incorrecto

Lista de precios

Petición:

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

Parámetros:

$api_keyTu clave API
$serviceServicio a pedir(opcional)
$countryPaís del número(opcional)

Respuesta:

{"Código de país": {"Código de servicio": {"Precio": Cantidad}}}

Errores:

BAD_KEY — clave API no válida
BAD_ACTION — acción incorrecta
BAD_COUNTRY — nombre de país incorrecto
BAD_SERVICE — nombre de servicio incorrecto