Descom Mensajes SMS

Añadir y modificar Contactos mediante interfaz HTTP



Mediante esta iterfaz podrá realizar añadir y modificar Contacos.

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

Añadir y Modificar Contactos
URL:
http://www.descomsms.com/servlet/dmapi.servlet.Servlet

Petición de envío
Para poder añadir y modificar Contactos, deberán de acceder al URL arriba indicada proporcionando la siguiente información en formato POST:

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

Definición de trama de autentificación y añadir Contactos

<TXEnvio>
<Autentificacion>
         <usuario>login usuario</Usuario>
         <passwd>contraseña de usuario </Passwd>
         <idcli>código de cliente</Idcli>
</Autentificacion>
<CONTACTOSSET accion=”CADD” accion_existe=”N,A,I” lista_asociar=”” lista_nueva=””>
         <cdcontacto>
                  <cdparametro>
                           <cdcampo>
                           <cdvalor>
                  </cdparametro>
                  <cdparametro>
                           <cdcampo>
                           <cdvalor>
                  </cdparametro>
                  ………………………
         </cdcontacto>
         <cdcontacto>
                  <cdparametro>
                           <cdcampo>
                           <cdvalor>
                  </cdparametro>
                  <cdparametro>
                           <cdcampo>
                           <cdvalor>
                  </cdparametro>
                  ………………………
         </cdcontacto>
        ………………………
</CONTACTOSSET >
</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 <CONTACTOSSET> Contiene:
Parámetros:

accion Acción a realizar: valores válidos:CADD
accion_existe

Acción a realizar si el móvil del contacto a añadir ya existe
N -> Se crea el contacto nuevo, se borra el que ya existe y se crea uno nuevo
A -> Se actualiza el contacto existente sólo con los datos pasados.
I -> Se Ignora modificar el contacto si ya existe

lista_asociar Código de lista a asociar Contactos
lista_nueva Nombre de lista nueva o existente a asociar contactos

El elemento <cdcontacto> define un grupo de parámetros de campos de un contacto, contiene:

<cdparametro> Datos de campo del contacto, contiene:

<cdcampo>

Nombre del campo del contacto.
Nombre de campo válidos:
nombre Nombre del contacto **
apellidos Apellidos del contacto **
numero Número de móvil del contacto *
sexo Sexo del Contacto. Valores válidos
H -> Hombre
M -> Mujer
N -> No Disponible
alias Alias
email Email
localizacion Localizacion
etiquetas Etiquetas
notas Notas o comentarios
cp Código postal
fnac Fecha de nacimiento en formato dd/mm/yyyy
empresa nombre de la empresa
operador Operador teléfonico
modelo Modelo de coche
marca Marca de Coche
tienecoche Si tiene coche. Valores válidos: si, no
tienecasa Si tiene casa. Valores válidos: si, no
tienehijos Si tiene hijos. Valores válidos: si, no

* Campos obligatorios
** Campos recomendados

<pbvalor>

Valor del texto asociado al campo en formato hexadecimal
Valores según campo
nombre Texto alfanumérico
apellidos Texto alfanumérico
numero Número de móvil sin espacios, en formato nacional 666555444 o en formato internacional 0034666555444
sexo Sexo del Contacto. Valores válidos
H -> Hombre
M -> Mujer
N -> No Disponible
alias Texto alfanumérico
email Texto alfanumérico
localizacion Texto alfanumérico
etiquetas Texto alfanumérico
notas Texto alfanumérico
cp Código postal en formato numérico
fnac Fecha de nacimiento en formato dd/mm/yyyy
empresa Texto alfanumérico
operador Texto alfanumérico
modelo Texto alfanumérico
marca Texto alfanumérico
tienecoche Si tiene coche. Valores válidos: si, no
tienecasa Si tiene casa. Valores válidos: si, no
tienehijos Si tiene hijos. Valores válidos: si, no

Todos los valores en formato Hexadecimal

          

<RXEnvio>
<Autentificacion>
         <Usuario>8865736572303038</Usuario>
         <Resultado>1</Resultado>
         <Comentario>Autentificacion satisfactoria.</Comentario>
</Autentificacion>
<CONTACTOSADD>
         <total_contactos>3</total_contactos>
         <total_contactos_nuevos>0</total_contactos_nuevos>
         <total_contactos_actualizados>3</total_contactos_actualizados>
         <total_contactos_ignorados>0</total_contactos_ignorados>
         <total_contactos_errores>0</total_contactos_errores>
</CONTACTOSADD>
</RXEnvio>

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

El elemento <CONTACTOSADD> contiene :

total_contactos Total de contactos enviados para añadir
total_contactos_nuevos Total de contactos creados nuevos
total_contactos_actualizados Total de contactos actualizados
total_contactos_ignorados Total de contactos ignorados
total_contactos_errores Total de contactos no añadido por errores

 




Inicio - Contacto - Datos Identificativos - Aviso Legal - copyright: Descom SL. Descom Mensajes SMS y SMS Premium