API pública de SMS4You: API REST para la recepción de SMS, códigos OTP y números virtuales

1/7/2026

Os presentamos la API pública de SMS4You: automatizad la recepción de SMS y la gestión de números

Nos complace anunciar el lanzamiento de algo que muchos de vosotros llevabais tiempo esperando: la API pública de SMS4You. Ahora, todo lo que antes hacíais manualmente en vuestro panel de control, podéis hacerlo mediante programación: comprar números, obtener códigos de SMS y correo electrónico, y consultar el saldo y las tarifas. Vuestros scripts, bots y sistemas de registro pueden interactuar directamente con SMS4You, sin necesidad de hacer ni un solo clic.

A continuación os explicamos qué es exactamente lo que hemos lanzado, para qué sirve y cómo empezar en cinco minutos.

¿Para qué sirve la API?

La compra manual de números está bien cuando hay pocas activaciones. Pero en cuanto se trata de decenas o cientos de registros, procesamientos masivos o la integración de la recepción de SMS en su propio producto, hacer clic en la interfaz resulta poco práctico. La API resuelve precisamente este problema: describes la lógica una sola vez en el código y, a partir de ahí, todo ocurre automáticamente, en cualquier volumen y a cualquier hora del día.

Escenarios típicos para los que hemos creado esta solución:

el registro y la verificación automáticos de cuentas en tu software;
procesos masivos y pruebas en los que se necesitan muchos números seguidos;
integración de la recepción de códigos SMS directamente en tu servicio o producto;
migración de integraciones existentes desarrolladas para otros proveedores.

¿Qué puede hacer la API?

1. Activaciones «llave en mano»: desde la compra del número hasta la recepción del código

Todo el ciclo de vida de la activación está disponible a través de puntos finales REST intuitivos:

seleccionar el servicio y el país, consultar la disponibilidad y el precio;
comprar un número con una sola solicitud;
recoger el SMS recibido (o el correo electrónico, si se trata de una activación por correo electrónico);
finalizar, cancelar o solicitar un nuevo SMS: el control del estado está totalmente en tus manos.

Se admiten los dos productos clave: recepción de SMS (OTP) y activaciones por correo electrónico. Cada activación tiene un identificador único, mediante el cual podrás acceder a ella posteriormente.

2. Catálogo y precios actualizados

La API proporciona datos actualizados:

lista de países con prefijos telefónicos;
lista de servicios (para SMS y para correo electrónico);
precios por servicio o país concretos, así como una lista completa de precios con resultados por página.

Un detalle importante: los precios se muestran teniendo en cuenta tu descuento personal. Lo que ves en la respuesta de la API es exactamente lo que se deducirá de tu saldo.

3. Webhooks: los códigos te llegan solos

Consultar constantemente el servidor a la espera de un SMS es ineficiente y lento. Por eso, en SMS4You disponemos de webhooks: en cuanto llega un nuevo mensaje o cambia el estado de activación, nosotros mismos enviamos una solicitud HTTP a las direcciones que nos hayas indicado.

Recibes las notificaciones al instante, sin necesidad de realizar consultas;
cada llamada está firmada con una firma HMAC, por lo que puedes asegurarte de que la solicitud procede realmente de nosotros;
Se han implementado reintentos de entrega en caso de que su servidor no esté disponible durante un segundo;
Para aquellos que restringen el tráfico mediante una lista blanca, publicamos una lista de direcciones IP desde las que se envían los webhooks.

Junto con la API REST, esto completa la integración: tú mismo envías las solicitudes y recibes las actualizaciones a través de un canal push.

4. Compatibilidad con SMS-Activate: migración sin necesidad de reescribir el código

Esto es algo de lo que nos sentimos especialmente orgullosos. Si ya dispones de software desarrollado para la API de SMS-Activate, no es necesario que reescribas la integración. SMS4You es compatible con el protocolo: basta con cambiar la dirección del servidor por la nuestra e introducir tu clave.

Su código, bibliotecas y bots actuales seguirán funcionando tal cual, pero ya con los números, precios y calidad de SMS4You. Esto hace que el cambio a nuestro servicio sea cuestión de una sola línea en la configuración, en lugar de semanas de desarrollo.

5. Autenticación segura y sencilla

Sin nombres de usuario ni contraseñas en los scripts. Accedes a tu área de usuario, creas un token personal en la pestaña «Tokens de API» y lo utilizas en las solicitudes. El token se puede transmitir de tres formas; elige la que resulte más cómoda para tu biblioteca:

en el encabezado Authorization: Bearer <токен>;
en el encabezado X-Api-Token: <токен>;
como parámetro de consulta ?api_token=<токен>.

Puedes crear varios tokens (por ejemplo, uno distinto para cada proyecto) y revocar en cualquier momento uno que se haya visto comprometido, sin que ello afecte al resto. El valor del token se muestra una sola vez al crearlo; a partir de ahí, solo tú lo conservas.

6. Documentación interactiva

Hemos preparado una documentación interactiva basada en OpenAPI: se describe cada punto final, se indica el tipo de cada campo y las solicitudes se pueden ejecutar directamente desde la página, sin necesidad de abrir el terminal. Allí también hay una sección dedicada a los webhooks y al protocolo compatible con SMS-Activate.

La documentación está disponible en docs.sms4you.org.

Inicio rápido en cinco minutos

Dirección base de la API: https://api.sms4you.org/api/v1

Paso 1. Comprobamos el saldo y el descuento de la cuenta

curl https://api.sms4you.org/api/v1/me \
  -H "Authorization: Bearer YOU TOKEN"

{
  "data": {
    "name": "Ivan",
    "email": "[email protected]",
    "email_verified": true,
    "balance": "12.3456",
    "currency": "USD",
    "discount_percent": 5
  }
}

Paso 2. Consultamos el precio del servicio deseado

curl "https://api.sms4you.org/api/v1/prices?service_id=SERVICE_ID" \
  -H "Authorization: Bearer YOU TOKEN"

Paso 3. Compramos el número

curl -X POST https://api.sms4you.org/api/v1/activations \
  -H "Authorization: Bearer YOU TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"service_id": 123, "country_id": 7, "price": "0.20"}'

En la respuesta recibirás el número de teléfono y el código de activación.

Paso 4. Recibimos el SMS

curl https://api.sms4you.org/api/v1/activations/АКТИВАЦИЯ_ID/messages \
  -H "Authorization: Bearer YOU TOKEN"

Y si configuras un webhook, este paso ni siquiera será necesario: el código te llegará automáticamente.

Límites y fiabilidad

Las solicitudes están limitadas en cuanto a frecuencia (por defecto, hasta 120 solicitudes por minuto), para que el servicio se mantenga estable para todos.
Todas las respuestas se envían en un formato único, incluidos los errores: un código claro, un mensaje legible y, si es necesario, detalles adicionales. Procesarlas en el código es muy sencillo.
Para realizar compras se requiere un correo electrónico verificado en la cuenta, una medida de seguridad habitual.

¿Para quién es esto?

A los desarrolladores que necesitan recibir SMS dentro de su producto.
A los equipos de arbitraje y marketing, donde los registros se producen a un ritmo vertiginoso.
A los equipos de control de calidad que prueban escenarios con verificación telefónica.
A todos aquellos que ya utilizan software compatible con SMS-Activate y buscan un proveedor sin complicaciones de migración.

¿Y ahora qué?

La API pública es la base sobre la que seguiremos construyendo. Tenemos previsto ampliar la cobertura de productos y funcionalidades, escuchando vuestras peticiones. Si echáis en falta algún punto final o escenario, escribidnos a través del chat de asistencia: leemos todo y damos prioridad a lo que realmente se necesita.

Pruébalo ahora mismo:

Accede a tu cuenta personal y crea un token en la pestaña «Tokens de API».
Abre la documentación en docs.sms4you.org.
Realiza la primera solicitud y automatiza todo lo demás.

Que disfrutes de la integración y que los códigos lleguen a tiempo.