API HTTP-XML: responder a los SMS

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