OLD Desarrolladores SMS y API SMS

sdk-httpxml-a

1. Descripción

 

Este es un ejemplo de aplicación de SMS Recibido / SMS Respuesta con la finalidad de generar una codificación que controla el acceso a una zona web.

Como funciona

Una página web solicita al usuario un código para acceder a un área restringida. El código es enviado por SMS, previa solicitud. Al introducir el código en la página web, un script compruebe su validez y permisos.

Sintaxis y utilización de la llamada para validar un código.

Para que la web de contenidos pueda validar si un código es valido, debes llamar a una URL en la que se pasara como parámetro el código a validar, de manera que :

  • Si la URL devuelve un 1-> El código es válido y se hace 1 uso
  • Si la URL devuelve un 0 -> El código no es válido o ya ha caducado o consumido todos sus usos. 

 

La URL de validación de códigos es la siguiente:

http://www.descomsms.com/AP/micropago.servlet.Servlet?codigo=CODIGO&idc="codigo cliente"&pmp="palabra servicio"

donde:

Nombre
Parámetro
Descripción Posibles Valores Tipo de
Dato
codigo Código introducido para validar Alfanumérico
idc Código numérico de cliente en Descom SMS Numérico
pmp Palabra clave del servicio en Descom SMS AlfaNumérico

 

3. Ejemplos

ASP

Utilizamos el objeto XMLHttpRequest
para validar el código del servicio 
a través de una url.

Requisitos:
----- 
Ficheros: 
Fuentes

Demo

 

Requisitos:

----- 

Ficheros:

 Fuentes

 

PHP

Abrimos un socket con
el que nos comunicamos
con la plataforma para 
validar el código del servicio.


Requisitos:
PHP 4.3.0 o superior

Ficheros:
Fuentes
 

Demo Online

 

Requisitos:

PHP 4.3.0 o superior

Ficheros:

Fuentes

Acceso a Demo Online

 

4. Gráfico

By

sdk-httpxml-a

 

1. Descripción

En este caso, el SMS respuesta al mensaje recibido se genera automáticamente, su contenido se construye dinámicamente en función del texto del mensaje recibido y es posible devolver un texto definido en la configuración del servicio o bien una URL.

El script genera la respuesta de forma inmediata y en texto plano; para otro tipo de respuestas, consultar Responder SMS Recibidos.

 

SDKRecibir-Respuesta-Automatica

2. Documentación

Recibimos un mensaje completo, incluyendo el número de móvil y el código de identificación del mensaje.

Podemos pasar el mensaje completo a través de un único parámetro "p1" o bien pasar cada palabra del mensaje como parámetros independientes "p1", "p2","p3"...

Recomendamos pasar el mensaje completo como parámetro "p1" a no ser que necesitemos parámetros individuales por cada palabra del mensaje.

Parámetros

En el Script de recepción de mensajes deberemos obtener como parámetros POST los siguientes datos:

Parámetro Descripción Posibles Valores Tipo de
Dato
m1

Número de móvil de quien manda el SMS en formato internacional

Numérico
id identificador unico del mensaje recibido.
Numérico
p1 Mensaje estrito en el SMS Alfanumérico

p1,p2,p3,... Cada parámetro contiene una plabra independiente del mensaje escrito en el SMS

 

3. Ejemplos

ASP


Recibimos los parámetros y
respondemos en texto plano.
Requisitos:
----- 
Ficheros: 
Fuentes

PHP


Recibimos los parámetros y
respondemos en texto plano.
Requisitos
-----
Ficheros 
Fuentes

 

4. Gráfico

By

sdk-httpxml-a
1. Descripción

Mediante esta API podrás contestar a cualquier mensaje recibido en tu cuenta. La contestación será enviada a nuestro servidor para ser entergada como un SMS en el destinatario original del mensaje.

La respuesta a los mensajes recibidos se realiza a través de una url, con o sin servidor seguro. Esta información contiene la información requerida para la respuesta del mensaje.

2. Documentación

URL

https://seguro.descom.es/telapp/descomMensajes/descomrespmo.php

 

Petición de envío

Para poder enviar los mensajes de respuesta, deberás acceder al servidor seguro a la URL arriba indicada proporcionando la siguiente información en formato POST:

 

Parámetros POST:

Nombre
Parámetro
Descripción Posibles Valores Tipo de
Dato
Usuario Identificador de Usuario en Descom SMS Nombre de usuario Hexadecimal
clave Contraseña de acceso Contraseña Hexadecimal
destino Número de teléfono Móvil de mensaje a responder Teléfono en formato:
acceso internacional + cod. país + teléfono Ejemplo: 0034666555444
Numérico
id Identificador numérico del mensaje a responder Valor numérico que puede obtener de la página de mensajes No respondidos Numérico
texto Texto del mensaje de respuesta a enviar a destino Texto del mensaje de respuesta a enviar a Destino. Como máximo 160 caracteres.  

 

Los valores 'id' y 'destino' los puedes obtener de la lista de mensajes recibidos no respondidos en la Categoría asíncrona el página Web de la plataforma de su cuenta.

 

Respuesta

La información retornada será recibida en formato XML, conteniendo la siguiente estructura:

Estructura básica XML de respuesta:

Etiqueta Raiz: <RXEnvio>

Esta etiqueta debe envolver todos los datos XML de la llamada.

<RXEnvio>  Tus datos....  </RXEnvio>

Definición de trama de respuesta:

<RXEnvio>
<Autentificacion>
    <Usuario/>
    <Time/>
    <Resultado/>
    <Comentario/>
</Autentificacion>
<Mensajes>
   <Mensaje>
     <Id/>
     <Resultado/>
     <Comentario/>
   </Mensaje>
</Mensajes>
 </RXEnvio>
 


Donde:

Nombre
Parámetro
Descripción Posibles Valores Tipo de
Dato
Usuario Identificador de Usuario en Descom SMS Nombre de usuario Alfanumérico en Hexadecimal
Resultado Resultado de la autentificación en Descom SMS 1-> autentificación correcta
0->Fallo en la autentificación 
Numérico
Comentario Texto descriptivo del resultado de la autentificación   Alfanumérico
Saldo Saldo actual en Descom SMS de tu cuenta   Numérico

 

Por cada mensaje contestado, el elemnto <Mensaje> contiene.

Parámetro Descripción Posibles Valores Tipo de
Dato
Id

Identificador del mensaje respondido

  Numérico
Resultado Resultado del envio del mensaje 0 -> envío fallido
1 -> envío correcto
Numérico
Comentario Comentario enviado por el servidor con el resultado del envío.    

 

Ejemplos de Respuesta:

 <?xml version="1.0" encoding="UTF-8"?>
 <!--Secuencia de respuesta del Servidor a un envio del cliente-->
 <!--En este caso, envio Correcto-->
 <RXEnvio>
  <Autentificacion>
    <Usuario>user</Usuario>
    <Time>0402031550417</Time>
    <Resultado>1</Resultado>
    <Comentario>Autentificacion satisfactoria</Comentario>
  </Autentificacion>
  <Mensajes>
    <Mensaje>
      <Id>112233</Id>
      <Resultado>1</Resultado>
      <Comentario>Mensaje Respondido</Comentario>
    </Mensaje>
  </Mensajes>
 </RXEnvio>
 

<?xml version="1.0" encoding="UTF-8"?>
 <!--Secuencia de respuesta del Servidor a un envio del cliente-->
 <!--En este caso, envio Incorrecto-->
 <RXEnvio>
 <Autentificacion>
    <Usuario>user</Usuario>
    <Time>0402031550417</Time>
    <Resultado>1</Resultado>
    <Comentario>Autentificacion satisfactoria</Comentario>
 </Autentificacion>
 <Mensajes>
  <Mensaje>
    <Id>112233</Id>
    <Resultado>0</Resultado>
    <Comentario>Mensaje no Respondido</Comentario>
  </Mensaje>
 </Mensajes>
 </RXEnvio>
 

 <?xml version="1.0" encoding="UTF-8"?>
 <!--Secuencia de respuesta del Servidor a un envio del cliente-->
 <!--En este caso, la autentificacion es erronea,no se envia nada-->
 <RXEnvio>
 <Autentificacion>
    <Usuario>user</Usuario>
    <Time>040203100417</Time>
    <Resultado>0</Resultado>
 <Comentario>Autentificacion erronea</Comentario>
 </Autentificacion>
 </RXEnvio>
 

3. Ejemplo

Fuentes

4. Gráfico

By

sdk-httpxml-a

1. Descripción

Colocando un IFRAME en la página donde quieras tener el banner. Este IFRAME debe llamar a una página que contiene los elementos necesarios para solicitar la información de los mensajes a mostrar y unas funciones en javascript que permiten rotar esos mensajes en pantalla.

2. Ejemplos

ASP

Utilizamos el objeto XMLHttpRequest para

recibir los mensajes a mostrar en el banner.

Requisitos:

-----

Ficheros:

Fuentes

PHP

Abrimos un socket con el que nos comunicamos con la plataforma para recibir los mensajes a mostrar en el banner.

Requisitos:

PHP 4.3.0 o superior

Ficheros:

Fuentes

 

3. Gráfico

By

1. Descripción

Con este visor podrás recibir en cualquier aplicación Web o de escritorio los mensajes que recibas en tu cuenta en Descom SMS.

Es posible solicitar la información de los mensajes que queremos visualizar a través de una petición a url de un servidor seguro mediante unos parámetros prefijados; la información de los mensajes recibidos será devuelta en XML o texto plano.

2. Documentación

Petición XML:

https://seguro.descom.es/telapp/menvixml.php?usuario=descomuser&password=descompass

Petición Texto:

https://seguro.descom.es/telapp/menvitxt.php?usuario=decomuser&password=descompass


Para poder usar el visor de mensajes recibidos de Descom SMS, accede a nuestro servidor seguro proporcionando la siguiente información:

Los valores ingresados deberán cumplir los siguientes valores, para ser enviadas como parte de la petición:

Nombre
Parámetro
Descripción Posibles Valores Tipo de
Dato
Usuario ID del cliente ID del cliente Alfanumérico
password Contraseña de acceso a la plataforma Contraseña Alfanumérico
Tag Palabra clave de la categoría/sorteo/concurso palabra clave Alfanumérico
n_men Número de mensajes por página Número de paginas Numérico
Pila Orden de los Mensajes 1 - Ordenado por fecha más reciente
0 - Ordenado por fecha más antigua
Numérico
Ver Criterio de búsqueda por fechas T - Todos
D - Hoy
S - Semana
M - Mes
F - Rango de Fechas
Fini Fecha Inicial de búsqueda

formato "dd/MM/yyyy"
Ejemplo: 15/05/2003

Fecha
Ffin Fecha Final de búsqueda formato "dd/MM/yyyy"
Ejemplo: 15/05/2003
Fecha

 

Información retornada:

Se puede recibir la información en dos formatos diferentes: XML o texto, dependiendo de la petición enviada.

Formato XML:
<FM></FM>
<NUMERO></NUMERO>
<MENSAJE></MENSAJE>
<FECHA></FECHA>

Formato Texto:
FM--NUMERO--MENSAJE--FECHA

Nombre
Parámetro
Descripción Posibles Valores Tipo de
Dato
FM Identificador del mensaje Numérico
NUMERO Número de teléfono Numérico
MENSAJE Mensaje recibido Alfanumérico
FECHA Fecha de recepción formato "dd/MM/yyyy hh:mm:ss" Fecha

 

Actualización de información

Para refrescar la información automáticamente, la petición contendrá la siguiente información:

Nombre
Parámetro
Descripción Posibles Valores Tipo de
Dato
Last FM (identificativo del mensaje) del primer mensaje recibido en caso de recibir los mensajes ordenados por fecha mas reciente (pila=1).
Ó
FM (identificativo del mensaje) del ultimo mensaje recibido en caso de recibir los mensajes ordenados por fecha mas antigua (pila=0).
FM (identificativo del mensaje) Numérico
Pila Orden de los Mensajes 1 - Ordenado por fecha más reciente
0 - Ordenado por fecha más antigua
Numérico
Ver Criterio de búsqueda por fechas T - Todos
D - Hoy
S - Semana
M - Mes
F - Rango de Fechas
Fini Fecha Inicial de búsqueda
(formato "dd/MM/yyyy", ejemplo: 15/05/2003)
Fecha
Ffin Fecha Final de búsqueda
(formato "dd/MM/yyyy", ejemplo: 15/05/2003)
Fecha

Petición Refresh para formato XML:
<meta http-equiv="Refresh" CONTENT=" 30; URL=menvixml.php?parámetro=valor&parámetro=valor"

Petición Refresh para formato Texto:
<meta http-equiv="Refresh" CONTENT="30; URL=menvitxt.php?parámetro=valor&parámetro=valor"

Ejemplo de refresco para XML:
<meta http-equiv="Refresh" CONTENT=" 30; URL=menvixml.php?last=7400&pila=1&ver=D&fini=&ffin=">

Ejemplo de refresco para TEXTO:
<meta http-equiv="Refresh" CONTENT=" 30; URL=menvitxt.php?last=7400&pila=1&ver=D&fini=&ffin=">

Nota:
Hay que tener en consideración que mientras no se cierre el browser donde se esta visualizando los mensajes, la sesión de acceso estará activa, por lo cual no es necesario enviar toda la información para el refresco.

 

3. Ejemplos

Prueba nuestro Visor con los datos de tu cuenta y mensajes que hayas recibido: Demo Online

 

ASP

Utilizamos el objeto XMLHttpRequest

para recibir los mensajes a mostrar en el visor.

Requisitos:

-----

Ficheros:

Fuentes

PHP

Abrimos un socket con el que nos comunicamos con la plataforma para recibir los mensajes a mostrar en el visor.

Requisitos:

PHP 4.3.0 o superior

Ficheros:

Fuentes

 

4. Gráfico

By