SMS de LabsMobile: Primeros Pasos para Desarrolladores

Elige la versión que se adapte a tu entorno

En LabsMobile ofrecemos varias versiones de nuestra API según tu entorno y requisitos, incluyendo Librerías SDK, HTTP/POST (JSON), HTTP/GET, WebService, MailSMS, OTP, Admin y HLR. Recomendamos utilizar preferentemente la API HTTP/POST con JSON por su seguridad y facilidad de uso, aunque puedes escoger otra versión si se adapta mejor a tu proyecto.

Cada versión dispone de su propia documentación detallada, donde se describen los endpoints y parámetros disponibles. Por ejemplo, en la sección Versiones API del portal de desarrolladores se listan todas las opciones y características de cada API.

Explora nuestros ejemplos de código

En nuestra web de LabsMobile encontrarás ejemplos de código en múltiples lenguajes para facilitar la integración. Hay guías y fragmentos en C#, Java, PHP, Python, Node.js, Go, Ruby, Swift, y muchos más.

Estos ejemplos demuestran cómo realizar tareas comunes: enviar SMS individuales o masivos, consultar saldo, recibir notificaciones de entrega o mensajes entrantes, etc. Por ejemplo, en la documentación hay ejemplos de envío de SMS en Go, Python y otros lenguajes, junto con explicaciones paso a paso. Usa estos recursos para acelerar tu desarrollo. Además, la sección Documentación API provee más ejemplos y detalles sobre cada funcionalidad.

Prueba la API con nuestra colección de Postman

Para facilitar las pruebas, cada versión de la API de LabsMobile cuenta con una colección de Postman que puedes descargar y ejecutar inmediatamente. Por ejemplo, en la documentación de la API HTTP/POST encontrarás un enlace para descargar su colección de Postman.

También, hay colecciones para la API HLR y las demás versiones. Importa la colección en Postman y encontrarás ya preconfigurados los endpoints y encabezados necesarios (como la autenticación HTTP Basic). Así, podrás probar tus llamadas API de forma interactiva sin escribir código, ideal para validar parámetros y ver las respuestas JSON.

Autenticación y seguridad

Para comenzar la integración, necesitas una cuenta de LabsMobile (con tu correo registrado) y generar un token API que actuará como contraseña en la autenticación. Esto se hace desde la sección Configuración API del panel WebSMS de tu cuenta.

La API utiliza HTTP Basic Auth, enviando en cada petición las credenciales usuario:tokenAPI codificadas en Base64. Por ejemplo, si tu usuario es miUsuario y el token es abc123, incluirías en el header de autorización: Basic base64("miUsuario:abc123").

Opcionalmente, puedes configurar filtros de seguridad para reforzar tu integración. Entre ellos se incluye permitir solo ciertas direcciones IP de envío, definir un remitente por defecto, establecer límites diarios o por lote, aplicar filtros por países, y activar un filtro anti-duplicados para evitar envíos repetidos.

Estas opciones se ajustan también en la sección de configuración de tu cuenta. Ten en cuenta que hay un límite de 10 peticiones por segundo; superar esto puede llevar a bloqueos temporales de tu cuenta.

Usa las librerías nativas de LabsMobile

La forma más sencilla y recomendada de integrar el envío de SMS es mediante las librerías nativas (SDKs) oficiales de LabsMobile. Estas librerías encapsulan toda la lógica de conexión, autenticación y validación de la API, simplificando al máximo el desarrollo y reduciendo errores.

Actualmente, LabsMobile dispone de librerías nativas para entornos PHP y Node.js, disponibles públicamente en GitHub y en la sección Librerías y SDK del portal de desarrolladores. Con ellas puedes enviar mensajes, consultar saldo o procesar notificaciones con unas pocas líneas de código.

Para otros lenguajes o entornos, se recomienda utilizar la API HTTP/POST con formato JSON, que ofrece las mismas funcionalidades y es fácilmente integrable con cualquier tecnología que permita realizar peticiones HTTPS.

Estas opciones garantizan una integración estable, segura y mantenida oficialmente por LabsMobile, con soporte y actualizaciones continuas.

Selecciona el endpoint de la versión API que quieres probar

Si tu entorno de desarrollo no cuenta con una librería nativa de LabsMobile, o prefieres implementar tu propia conexión, puedes integrar el servicio directamente utilizando cualquiera de las versiones disponibles de nuestra API. Todas las versiones (HTTP/POST JSON, HTTP/GET, WebService, MailSMS, OTP, HLR, etc.) están completamente documentadas y pueden implementarse fácilmente desde cualquier lenguaje o framework que permita realizar peticiones HTTP seguras.

Una vez autenticado, elige el endpoint adecuado a la acción que deseas realizar. Cada API tiene sus propios endpoints; aquí algunos ejemplos prácticos de la API HTTP/POST:

• Enviar SMS (POST) – https://api.labsmobile.com/json/send: Permite enviar mensajes SMS individualmente o en lote.
• Consultar saldo (GET) – https://api.labsmobile.com/json/balance: devuelve los créditos disponibles en tu cuenta. No requiere parámetros adicionales.
• Consultar precios (GET) – https://api.labsmobile.com/json/prices: Obtiene la tarifa (en créditos) de uno o varios países destino. Envía un JSON con el arreglo de códigos de país.
• Gestión de envíos programados (POST) – https://api.labsmobile.com/json/scheduled: Permite cancelar o ejecutar envíos pendientes. Hay que enviar un JSON indicando el comando (send o cancel) y el subid del envío programado.
• Consulta HLR (GET) – https://api.labsmobile.com/hlr: (API HLR) valida el estado de un número móvil. Envía parámetros como el número de teléfono para obtener información HLR.

Estos son solo ejemplos. En la documentación oficial encontrarás todos los endpoints disponibles para cada versión de la API. Las peticiones se construyen generalmente especificando el método (GET o POST), la URL del endpoint, y los headers de autorización y contenido adecuado.

Realiza tu primera petición

Con todo configurado, ¡es hora de enviar una petición real! Por ejemplo, usando cURL para enviar un SMS con la API HTTP/POST:

curl -X POST "https://api.labsmobile.com/json/send" \
  -H "Content-Type: application/json" \
  -u "miUsuario:miTokenAPI" \
-d '{"message":"¡Hola desde LabsMobile!","tpoa":"LabsM","recipient":[{"msisdn":"123456789"}]}'

En este ejemplo, reemplaza miUsuario:miTokenAPI por tus credenciales reales. El cuerpo JSON incluye al menos el texto del mensaje (message), el remitente (tpoa) y el arreglo de destinatarios con su número (msisdn). La API responderá con un JSON indicando si el envío fue exitoso. Un resultado exitoso típico sería:

{
  "subid": "65f33a88ceb3d",
  "code": "0",
  "message": "Message has been successfully sent."
}

En caso de error, el campo code tendrá un valor distinto de 0 y message describirá el problema (por ejemplo, saldo insuficiente). Consulta la sección de códigos de error en la documentación para más detalles.

Una vez que entiendas cómo funciona el envío básico, puedes probar otros endpoints: por ejemplo, usando GET para /json/balance solo necesitas pasar las credenciales en Basic Auth, o POST con el JSON apropiado para /json/prices o /json/scheduled. La colección de Postman mencionada facilita estas pruebas sin escribir comandos.

Errores comunes y cómo resolverlos

• 401 – Unauthorized: Usuario o token incorrectos. Revisa las credenciales o genera un nuevo token.
• 400 – Bad Request: JSON mal formado o campos obligatorios faltantes.
• 429 – Too Many Requests: Exceso de peticiones por segundo. Ajusta tu límite o implementa colas.

Recomendaciones para entorno de producción

• Implementa reintentos con backoff exponencial.
• Guarda los códigos o identificadores de envío (subid) para seguimiento posterior.
• Activa notificaciones de entrega (DLR) para obtener confirmaciones automáticas.
• Monitorea tus tasas de entrega y errores desde el panel de control.
• El límite estándar es de 10 peticiones por segundo por cuenta. Si necesitas más capacidad implementa colas de envío (RabbitMQ, Redis, etc.) o un sistema asíncrono de reintento.

Conclusión

Integrar la API SMS de LabsMobile es rápido si sigues estos pasos. Elige la versión que mejor convenga a tu entorno, examina los ejemplos de código disponibles, genera tu token API en el panel de WebSMS, y selecciona el endpoint correcto. Con la autenticación lista y los filtros de seguridad ajustados a tu gusto, ya puedes enviar tu primer mensaje de prueba.

En LabsMobile ofrecemos toda la documentación y soporte necesario para que la integración sea fluida. Así, con cada mensaje enviado tu proyecto estará aprovechando una plataforma especializada en SMS profesional, conectando eficientemente con tus usuarios finales.

Para más información consulta la documentación oficial de la API de LabsMobile y la sección de ejemplos de código, donde encontrarás guías detalladas y muestras de integración en diversos entornos de desarrollo. ¡Empieza a enviar tus SMS hoy mismo!

Recursos adicionales

• Documentación oficial de la API SMS: Encuentra toda la especificación técnica y guías de integración.
• Ejemplos de código: Explora ejemplos prácticos en varios lenguajes.
• Colección Postman: Descarga la colección y prueba la API directamente.
• Base de conocimientos y FAQs: Consulta guías, artículos y solución de problemas.
• Contacto directo: Si necesitas ayuda personalizada, completa el formulario.

Comienza a enviar tus primeros SMS hoy mismo con LabsMobile. Crea una cuenta gratuita y obtén tu token API en minutos.