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

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