API HTTP: programar SMS
1. Descripción
El Interfaz HTTP para programar mensajes te permite enviar mensajes prácticamente desde cualquier plataforma.
Solo tienes que integrar la llamada a una URL en el lenguaje de programación que estés utilizando.
Podrás enviar mensajes desde una página Web con un simple formulario, una aplicación gráfica en Windows, un script en linea de comandos en Linux, etc...
La llamada a la URL se hace pasando como parámetros las credenciales de autenticación, el mensaje y los destinatarios.
2. Documentación
URL:
Encriptada:
https://www.descomsms.com/dmapi/dmsend.phpsin encriptar:
http://www.descomsms.com/dmapi/dmsend.php
Petición de envío
Para poder programar mensajes, deberás acceder a la URL arriba indicada
proporcionando la siguiente información en formato POST:
Parámetros POST:
Los valores ingresados deberán cumplir los siguientes valores, para ser enviados como parte de la petición:
| Nombre Parámetro |
Descripción | Posibles Valores | Tipo de Dato |
| usuario | Identificador de usuario | Identificador de usuario en Descom SMS | Alfanumérico |
| clave | Contraseña de acceso a la plataforma | Contraseña del usuario en Descom SMS |
Alfanumérico |
| idc | Identificador de cliente | Identificador de cliente en Descom SMS | Numérico
|
| rem | Remitente personalizado* | Una cadena alfanumérica de hasta 11 caracteres | Alfanumérico |
| dest | Números de teléfono destinatario del mensaje |
Teléfono en formato: Para enviar varios destinatarios, separa cada número por coma. Ej: 0034666555444,0034666555441,0034666555442 |
Numérico |
| texto | Texto del mensaje |
Texto del mensaje a enviar, URL codificado. |
Alfanumérico |
| max | Numero máximo de sms a dividir |
0 -> para no tener límite de SMS. (por defecto) Un número mayor que cero para indicar el máximo de SMS de un mensaje largo. |
Numérico |
| aviso |
Envía un aviso de notificación cuando se envíe la programación |
0 -> No envía notificación por email (por defecto) |
Numérico |
| progini | Fecha de inicio de la programación |
Formato de fecha: ddmmyyyy Si se omite este parámetro se toma como fecha la del día actual Ej: 01122010 -> 1 de Diciembre de 2010, 31062010 -> 31 de Junio de 2010 |
Numérico |
| proghora | Hora de la programación |
Formato de Hora: hhmm Ej: 1233 -> 12 horas y 33 minutos. 0805-> 8 horas y 5 minutos |
Numérico |
* Puedes personalizar el remitente de los SMS, con su número de móvil autorizado, en formato no internacional (ej: 609111222), o con una cadena de texto; en este caso, consulte antes con Esta dirección de correo electrónico está protegida contra spambots. Usted necesita tener Javascript activado para poder verla. para configurar su remitente.
Programar un mensaje simple
LLamada:
https://www.descomsms.com/dmapi/dmsend.php?usuario=xxx&clave=xxx&idc=xxx&dest=00346xxxxxxxx&texto=Hola&progini=ddmmyyyy&proghora=hhmmRespuesta:
Programación correcta
OK: IDPROG: 123456 POK: 1 PERR: 0
o en caso de error de programación
ERR: IDPROG: 0 POK: 0 PERR: 1
Enviar un mensaje múltiple
LLamada:
https://www.descomsms.com/dmapi/dmsend.php?usuario=xxx&clave=xxx&idc=xxx&dest=00346xxxxxxx1,00346xxxxxxx2,00346xxxxxxx3&texto=Hola
Respuesta:
Programación correcta
OK: IDPROG: 123456 POK: 3 PERR: 0
o en caso de error de programación
ERR: IDPROG: 0 POK: 0 PERR: 3
Donde:
La primera línea devuelve el estado y resumen de la progrmación.
| Nombre | Descripción | Valores | Tipo de Datos |
| IDPROG | Identificador alfanumérico de la programación. Este identificador te puede servir para obtener el reporte de envío asociado. | Alfanumérico | |
| POK | Número de mensajes programados correctamente | Numérico | |
| PERR | Número de mensajes no programados | Numérico |
3. Ejemplos
4. Gráfico
Soporte Técnico:
 |
Esta dirección de correo electrónico está protegida contra spambots. Usted necesita tener Javascript activado para poder verla. |
Ahora puedes enviar también los mensajes SMS con Outlook, de forma fácil y segura.
[más info]
