Acceso Area de ClienteArea Cliente LLamanos al 965 861 024965 861 024

SDK-HTTP-B

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.php

sin 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:

https://www.descomsms.com/dmapi/dmsend.php ?usuario=xxx&clave=xxx&idc=xxx&dest=xxxxxx&texto=xxxxxx&progini=ddmmyyyy&proghora=hhmm

 

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:
acceso internacional + cod. país + teléfono Ejemplo: 0034666555444

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)
1 -> Sí envía notificación por email.

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á siendo protegida contra los robots de spam. Necesita tener JavaScript habilitado para poder verlo. 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=hhmm

Respuesta:

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

Descarga nuestros ejemplos: ejemplo online

4. Gráfico

Enviar-SMS-InterfazHTTP

Soporte Técnico:

ic-email Esta dirección de correo electrónico está siendo protegida contra los robots de spam. Necesita tener JavaScript habilitado para poder verlo.

Nagios

Nagios

Recibe las alertas por SMS, integrando el envío de mensajes en las notificaciones de Nagios.
[más info