API HTTP-XML: programar el envío de mensajes SMS

sdk-httpxml-a

 

1. Descripción

La interfaz HTTP-XML de mensajes programados te permitirá gestionar tus programaciones para altas, bajas y modificaciones.
Podrás obtener el listado completo de las programaciones que tengas o seleccionarlas según un filtro de búsqueda.
Para realizar nuevas programaciones o añadir mensajes a una programación ya existente, deberás consultar el apartado de cómo programar mensajes dentro de la API Enviar SMS.

2. Documentación

URL:
 http://www.descomsms.com/AP/dmapi.servlet.Servlet

Peticiones de envío:
Para poder recibir el listado de programaciones, deberán de acceder a la URL arriba indicada proporcionando la siguiente información en formato POST:

 

Parámetros POST:
xml: Trama XML de petición de búsqueda de reports 

Definición de trama de autentificación y parámetros de Acciones 

<TXEnvio>
   <Autentificacion>
       <Usuario>login usuario</Usuario>        
       <Passwd>contraseña de usuario </Passwd>        
       <Idcli>código de cliente</Idcli>    
   </Autentificacion>
   <Progset accion=”PGET”>
        <prog_id>id de report</prog_id>
    </Progset>
</TXEnvio>

 


El elemento <Autentificacion> contiene :

 

<usuario> Login  del usuario en formato hexadecimal
<passwd> Password del usuario en formato hexadecimal
<idcli> Código numérico de Cliente al que pertenece el usuario

 

El elemento <Progset> contiene :

<accion>

Acción a realizar en la petición

Tipos de Acciones:

PGET Obtener listado de programaciones, o programación seleccionada.
PDEL Borrar Programación seleccionada.
PELMENS Borrar Todos los mensajes de la programación seleccionada.

 

<prog_id> Identificador de la Programación

 

 

 

Definición de Trama de Respuesta de Mensajes enviados:

<RXEnvio>
    <Autentificacion>
        <Usuario>8865736572303038</Usuario>
        <Resultado>1</Resultado>
        <Comentario>Autentificacion satisfactoria.</Comentario>
    </Autentificacion>

 

El elemento <Autentificacion> contiene :

 

<Usuario> Login  del usuario en formato hexadecimal
<Resultado>

Resultado de la autenticación
1 -> autenticación correcta
0 -> fallo de autenticación

<Comentario>
comentario del resultado de la autenticación

 

 

 

Lista de Programaciones recibidas:

<PROGSLIST ntotal="1">
    <PROG>
        <PN>31</PN>
        <PID>37</PID> 
        <PNAME>50726f676f6e6c696e655f392f362f323031302031353a3035</PNAME> 
        <PREM>70616c6f6d696e6f</PREM> 
        <PDESC>556e612056657a20656c203c623e30392f30362f323031303c2f623e2061206c61732031353a3035</PDESC> 
        <PACTIVA>31</PACTIVA> 
        <PHH>3135</PHH> 
        <PHM>3135</PHM> 
        <PFINI>323031302d30362d3039</PFINI> 
        <PFFIN>323031302d30362d3039</PFFIN> 
        <PDIAS></PDIAS> 
        <PDIAM>31</PDIAM> 
        <PMES>31</PMES> 
        <PLASTMENS>312064652031</PLASTMENS> 
        <PLAST>323031302d30362d30392031353a30353a31312e30</PLAST> 
        <PAVISAR>31</PAVISAR> 
        <PNC>31</PNC> 
    </PROG>
</PROGSLIST>
</RXEnvio>

 

El elemento <Progslist> contiene :

 

<ntotal> Número total de programaciones obtenidas
<PN> Contador de la programación en la lista devuelta
<PID> Identificador de la programación en el servidor
<PNAME> Nombre de la programación
<PREM> Remitente para los mensajes programados
<PDESC> Descripción de la programación
<PACTIVA> Nos dice si la programación está activa o no
<PHH> Hora de la programación
<PHM> Minutos de la programación
<PFINI> Fecha de inicio
<PFFIN> Fecha de fin
<PDIAS> Dias de la semana
<PDIAM> Dia del mes
<PMES> Mes
<PLASTMENS> Número de mensajes enviados
<PLAST> Fecha de último envío
<PAVISAR> Avisar por correo del envío
<PNC> Número de contactos

 

 

{codecitation class="brush: xml; gutter: false;toolbar:false"}

3. Ejemplos

Descarga nuestros ejemplos o accede a una demo online: demo online PHPdescargar ejemplos en PHP.

4. Gráfico