Area de desarrollo SMS - SDK Fuentes SMS

Descomsms.com
Area de Desarrolladores
Interfaz DLL
Interfaz Java
Interfaz Http
Interfaz DM SMS

Interfaz informe Reports Http
Interfaz informe Mensajes Http

Interfaz Busqueda de Contactos Http
Interfaz Listas de Contactos Http
Interfaz Añadir Contactos Http

Registrar usuario
Contactanos

Busqueda de Contactos Avanzada, Asociación de Contactos a Listas y Borrado de Contactos con búsqueda mediante interfaz HTTP

Mediante esta iterfaz podrá realizar una búsqueda de contactos según los parámetros que proporcione.
Para ello debe enviar sus datos de autenticación y los parámetros de búsqueda de contacto.
Las 3 acciones que puede realizar con esta interfaz son: Búsqueda de Contactos, Asociar contactos a lista y borrar contactos. Todas las acciones teniendo siempre en cuenta los criterios de búsqueda.

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

Búsqueda Avanzada de Contactos
URL:
http://www.descomsms.com/servlet/dmapi.servlet.Servlet

Petición de envío
Para poder recibir el informe de 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 petición de búsqueda de Contactos

<TXEnvio>
<Autentificacion>
         <usuario>login usuario</Usuario>
         <passwd>contraseña de usuario </Passwd>
         <idcli>código de cliente</Idcli>
</Autentificacion>
<CONTACTOSGET acción=”CGET,CDEL,LASOC”>
      <cbusqueda>
         <cunion>AND, OR</cunion>
         <orden1_campo></orden1_campo>
         <orden1_tipo></orden1_tipo>
         <orden2_campo></orden2_campo>
         <orden2_tipo></orden2_tipo>
         <orden3_campo></orden3_campo>
         <orden3_tipo></orden3_tipo>
         <sel_aleatoria></sel_aleatoria>
         <lista_asociar></lista_asociar>
         <lista_nueva></lista_nueva>
         <lista_noexiste></lista_noexiste>
         <cfilas></cfilas>
          <cdesde></cdesde>
         <cbparamlist union=”AND, OR”>
                  <cbparametro>
                           <pbcampo></pbcampo>
                           <pbvalor></pbvalor>
                           <pboperador></pboperador>
                  </cbparametro>
………………………
         <cbparamlist>
……………………………………..
     </cbusqueda>
</CONTACTOSGET>
</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

Tipos en parámetro “accion”:

CGET: Obtiene Contactos según criterio de búsqueda.
CDEL: Borra Contactos según criterio de búsqueda.
LASOC: Asocia Contactos a Lista según criterio de búsqueda.

El elemento <cbusqueda> contiene :

<union>

Tipo de unión de grupos de criterios: AND, OR

<orden1_campo>

Primer campo de ordenación .
Campos válidos:

id	identificador del contacto
nombre	Nombre del contacto
apellidos	Apellidos del contacto
numero	Número de móvil del contacto
sexo	Sexo del Contacto. Valores válidos
alias	Alias
email	Email
localizacion	Localizacion
etiquetas	Etiquetas
notas	Notas
cp	Código postal
edad	Edad
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.
tienecasa	Si tiene casa.
tienehijos	Si tiene hijos
lista	Código de lista

<orden1_tipo>

Tipo de ordenacion primer campo: ASC, DESC

<orden2_campo>

Segundo campo de ordenación :

<orden2_tipo>

Tipo de ordenacion segundo campo: ASC, DESC

<orden3_campo>

Tercer campo de ordenación :

<orden3_tipo>

Tipo de ordenacion tercer campo: ASC, DESC

Sólo para asociar contactos listas

<sel_aleatoria>

Seleccionar aleatoriamente X contactos del total

<lista_asociar>

Código de lista a asociar Contactos

<lista_nueva>

Nombre de lista nueva o existente a asociar contactos

limite de contactos a obtener, máximo 100 por petición

punto desde donde obtener registros, comenzando en 1

El elemento <cbparamlist> define un grupo independiente de criterios, contiene:

Parámetro "union"

Tipo de unión para el grupo de campos del criterio: AND, OR

Datos de parámetro de búsqueda, contiene:

Nombre del campo a buscar.
Nombre de campo válidos:

id	identificador del contacto
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
edad	Edad
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
lista	Código de lista

Valor del texto a buscar en formato hexadecimal

Operador a aplicar en el criterio:
Tipos de operadores:
EQ ->igual que
NEQ -> distinto que
IN -> Contiene
NIN -> No Contiene
GET -> Mayor o Igual que
LEQ -> Menor o Igual que

Definición de Trama de Respuesta de Búsqueda de Contactos:

<RXEnvio>
<Autentificacion>
         <Usuario>8865736572303038</Usuario>
         <Resultado>1</Resultado>
         <Comentario>Autentificacion satisfactoria.</Comentario>
</Autentificacion>
<CONTACTOSLIST ntotal="837" nfilas="15" ndesde="1">
<LCONTACTO>
      <LCN>1</LCN>
      <LCID>146540</LCID>
      <LCNUMERO>0034601001607</LCNUMERO>
      <LCNOMBRE>6331363037</LCNOMBRE>
      <LCAPELLIDOS>6133657234356b366e70</LCAPELLIDOS>
      <LCTRATAMIENTO/>
      <LCALIAS/>
      <LCSEXO/>
      <LCLOCALIZACION/>
      <LCETIQUETAS>6b6a687064</LCETIQUETAS>
      <LCNOTAS/>
      <LCCP/>
      <LCFNAC/>
      <LCEMPRESA/>
      <LCOPERADOR/>
      <LCTIENECASA/>
      <LCTIENEHIJOS/>
      <LCTIENECOCHE/>
      <LCMARCA/>
      <LCMODELO/>
</LCONTACTO>
……………………
<LCONTACTO>
…………………
</LCONTACTO>
</CONTACTOSLIST>
</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 <CONTACTOSLIST> contiene :
Parámetros:

ntotal	Total de Contactos encontrados en la búsqueda
nfilas	Registros contactos mostrados en la trama devuelta
ndesde	A partir de qué registro se está mostrando en la trama devuelta

<LCONTACTO> - Registros por cada Contacto encontrado en la búsqueda
El elemento <LCONTACTO> contiene :

LCN	Número de registro en la respuesta
LCID	Identificador del Contacto
LCNUMERO	Número de móvil
LCNOMBRE	Nombre
LCAPELLIDOS	Apellidos
LCTRATAMIENTO	Tratamiento
LCALIAS	Alias
LCSEXO	Sexo H -> Hombre M -> Mujer N -> No Disponible
LCLOCALIZACION	Localización
LCETIQUETAS	Etiquetas
LCNOTAS	Notas o comentarios
LCCP	Codigo Postal
LCEMPRESA	Empresa
LCOPERADOR	Operador
LCTIENECASA	Tiene Casa. Valores válidos: si, no
LCTIENEHIJOS	Tiene Hijos. Valores válidos: si, no
LCTIENECOCHE	Tiene Coche. Valores válidos: si, no
LCMARCA	Marca de Coche
LCMODELO	Modelo de Coche

* Todos los datos en LCONTACTO devueltos en formato hexadecimal.

Definición de Trama de Respuesta de Asociación de Contactos a Lista:

<RXEnvio>
<Autentificacion>
         <Usuario>8865736572303038</Usuario>
         <Resultado>1</Resultado>
         <Comentario>Autentificacion satisfactoria.</Comentario>
</Autentificacion>
<CONTACTOSLASOC>
         <total_contactos_asociados>0</total_contactos_asociados>
</CONTACTOSLASOC>
<LISTASLIST ntotal="1">
         <LISTA>
                  <LN>1</LN>
                  <LID>13902</LID>
                  <LNAME>70656c616d6f6e6173</LNAME>
                  <LPCLAVE/>
                  <LNC>837</LNC>
         </LISTA>
</LISTASLIST>
</RXEnvio>

<CONTACTOSLASOC> -Resultado de la asociación de contactos
El elemento <CONTACTOSLASOC> contiene :

total_contactos_asociados

Total de contactos asociados a la lista

<LISTALIST> -Datos de la lista a la que se han asociado los contactos
El elemento <LISTALIST> contiene :

<LISTA>	Datos de la lista asociada
Parámetro "ntotal"	Numero de listas devueltos
LN	Número de registro en la respuesta
LID	Identificador del Contacto
LCNAME	Nombre de la Lista
LPCLAVE	Palabra clave de la Lista
LNC	Numero de Contactos en la Lista

* Todos los datos en <LISTA> devueltos en formato hexadecimal.

Definición de Trama de Respuesta de Borrado de Contactos:

<CONTACTOSDEL> -Resultado del borrado de contactos
El elemento <CONTACTOSDEL> contiene :

total_contactos_borrados

Total de contactos borrados

Inicio - Contacto - Datos Identificativos - Aviso Legal - copyright: Descom SL.