Saltar a: navegación, buscar

BBDDs:AltasYBajas

Revisión del 16:24 25 mar 2019 de Gorka (discusión | contribuciones) (→‎Variables)
(dif) ← Revisión anterior | Revisión actual (dif) | Revisión siguiente → (dif)

Altas

Para dar de alta un nuevo registro en cualquier base de datos suya, necesitara tener creada su Base de Datos en el Panel de Mobeleader.

URL

La url a la que tienen que ir todas las altas es http://static.mobeleader.com/webservices/users.php y mediante GET se le pasaran todas las variables.

Variables

  • Obligatorias:
    • hash: Contendrá el hash que le demos al cliente para saber a que BD pertenece de mailing pertenece el usuario o la baja.
    • tipo: en el caso de las altas siempre va a contener la palabra 'alta'
    • email: El email a dar de alta o de baja
    • sourcealta: Es de donde proviene esta alta (la web, aplicación..)
  • Opcionales (y sólo si es de alta)
    • ip: La ip desde la que el usuario a dar de alta realizo el alta
    • aid: El GAID (Google Advertisment ID) de Android, el IDFA (Identifier For Advertisers) de iOS o el AID (Advertisement ID) de Windows Phone
    • nombre: El nombre del usuario a dar de alta
    • apellidos: El apellido del usuario a dar de alta
    • fnacimiento: La fecha de nacimiento del usuario a dar de alta en formato [YYYY-MM-DD], esto es año-mes-día.
    • sexo: El sexo del usuario a dar de alta. Pueden existir dos opciones.
      • M: En caso de que sea Masculino
      • F: En caso de que sea Femenino
    • telefono: El teléfono del usuario a dar de alta
    • cod_pais: El código de país del usuario a dar de alta. Este código de país puede ser en ISO 3166-1 código-alfa2, ISO 3166-1 código-alfa-3 o ISO 3166-1 código-númerico
    • cp: El código postal del usuario a dar de alta
    • provincia: La provincia del usuario a dar de alta
    • falta: La fecha en la que se dio de alta el usuario en formato timestamp de unix.
  • Otros Opcionales (orientados a terminales móviles) (y sólo si es de alta)
    • ciudad: La ciudad del usuario a dar de alta
    • direccion: La dirección del usuario
    • latitud: La latitud donde se ha realizado el alta
    • longitud: La longitud donde se ha realizado el alta
    • terminaltipo: El tipo de terminal que es. Pueden existir las siguientes opciones:
      • movil
      • tableta
      • reloj
      • tv
      • iphone
      • ipad
      • iwatch
      • appletv
    • terminalso: El sistema operativo desde el que se ha dado de alta el terminal. Pueden existir dos opciones:
      • android: En caso de que sea Android
      • ios: En caso de que sea ios
    • terminalsoversion: Versíon del sistema operativo del terminal, ejemplo: 10.2, 5.1.1
    • terminalmarca: La Empresa manufacturadora del terminal, ejemplo: Sony, Apple, Samsung
    • terminalmodelo: El modeló del terminal, ejemplo: 7 plus, Galaxy S
    • terminalmodelocod: El código del modeló del terminal, ejemplo: E2303
    • termnialpantallapulgadas: Las pulgadas del terminal, ejemplo: 5.2
    • terminalpantallaresolucionaancho: la resolución de ancho de la pantalla, ejemplo: 720
    • terminalpantallaresolucionaalto: la resolución de alto de la pantalla, ejemplo: 1184
    • terminalpantallappi: los Pixeles Por Pulgada, ejemplo: 320
    • terminalpantallapxratio: el ratio del pixel fisico con el device independet pixel, ejemplo: 1.500
    • terminaloperadorcodigo: el código de operador, ejemplo: 21401
    • terminaloperadorpais: el país de operador, ejemplo: ES. Este código de país debe ser en ISO 3166-1 código-alfa2
    • terminaloperadornombre: el nombre del operador, ejemplo: Vodafone
    • terminalidioma: idioma del telefono, ejemplo: ES. Este código de país debe ser en ISO 3166-1 código-alfa2
    • appbundle: el bundle de la aplicación donde se ha realizado el alta, ejemplo: com.prueba.pr
    • appversion: la versión de la aplicación, ejemplo:1.22
    • appversioncode: el código de versión de la app, ejemplo: 19
    • appnombre: el nombre de la app, ejemplo: iFacturas


También se pueden añadir campos extras que quieras guardar en tu BD, para ello solo tienes que pasarlo mediante GET como una variable nueva.

Ejemplos

Ejemplo Minimo --> http://static.mobeleader.com/webservices/users.php?hash=8265a49bad3cf&tipo=alta&email=prueba1@prueba.com&sourcealta=app1

Ejemplo Mas Datos --> http://static.mobeleader.com/webservices/users.php?hash=8265a49bad3cf&tipo=alta&email=prueba1@prueba.com&sourcealta=app1&fnacimiento=1992-01-12&cp=08240&provincia=Madrid&cod_pais=ESP&ip=85.48.99.18&aid=6D92078A-8246-4BA4-AE5B-76104861E7DC

Ejemplo Campos Extras --> http://static.mobeleader.com/webservices/users.php?hash=8265a49bad3cf&tipo=alta&email=prueba1@prueba.com&sourcealta=app1&fnacimiento=1992-01-12&cp=08240&provincia=Madrid&cod_pais=ESP&ip=85.48.99.18&aid=6D92078A-8246-4BA4-AE5B-76104861E7DC&campoExtra1=campoextra1&campoExtra2=campoextra2

Ejemplo Campos Extras desde app movil --> http://static.mobeleader.com/webservices/users.php?hash=8265a49bad3cf&tipo=alta&email=prueba1@prueba.com&sourcealta=app1&nombre=MiNombre&apellidos=MiApellido&fnacimiento=1992-01-12&cp=08240&telefono=456255456&provincia=Madrid&cod_pais=ESP&ip=85.48.99.18&aid=6D92078A-8246-4BA4-AE5B-76104861E7DC&latitud=43.2956&longitud=-2.9973&terminaltipo=movil&terminalso=android&terminalsoversion=5.1.1&terminalmarca=Sony&terminalmodelo=Xperia S&terminalmodelocod=E2303&termnialpantallapulgadas=5.2&terminalpantallaresolucionaancho=720&terminalpantallaresolucionaalto=1184&terminalpantallappi=320&terminalpantallapxratio=1.500&terminaloperadorcodigo=21401&terminaloperadorpais=ES&terminaloperadornombre=Vodafone ES&appbundle=com.prueba.pr&appversion=1.22&appversioncode=19

MODIFICACIONES

Para modificar un usuario ya creado anteriormente, necesitará suministrar los campos obligatorios que lo identifican y estos no pueden cambiarse.

URL

La url a la que tienen que ir todas las modificaciones es http://static.mobeleader.com/webservices/users.php y mediante GET se le pasaran todas las variables.

Variables

  • Obligatorias:
    • hash: Contendrá el hash que le demos al cliente para saber a que BD pertenece de mailing pertenece el usuario.
    • tipo: En el caso de las modificaciones siempre va a contener la palabra ‘modf’.
    • email: El email dado de alta. Este valor no puede modificarse, es la referencia para editar dicho registro. Cambiar el email supone un registro nuevo, no una modificación.
    • sourcealta: Es de donde provinió este registro, la alta original (la web, aplicación..). Este campo se podrá cambiar si fuera necesario.

El resto de campos opcionales y extras se pueden modificar, borrar o añadir a un registro que ya exista.

Si has rellenado un campo de cualquier tipo (Opcional o Extra) y deseas borrar su valor, deberás pasarlo junto con los campos mínimos necesarios que identifican al usuario indicando ‘null’ en el valor de dicho campo. ( campo=null ).

Ejemplos

Ejemplo Minimo: Con estos datos sabremos a que usuario realizar las modificaciones. A partir de aquí, podemos añadir a la url tantos campos como modificaciones queramos hacer —> http://static.mobeleader.com/webservices/users.php?hash=8265a49bad3cf&tipo=modf&email=prueba1@prueba.com&sourcealta=app1

Ejemplo Mas Datos --> http://static.mobeleader.com/webservices/users.php?hash=8265a49bad3cf&tipo=modf&email=prueba1@prueba.com&sourcealta=app1&fnacimiento=1992-01-12&cp=08240&provincia=Madrid&cod_pais=ESP&ip=85.48.99.18&aid=6D92078A-8246-4BA4-AE5B-76104861E7DC

Ejemplo Campos Extras --> http://static.mobeleader.com/webservices/users.php?hash=8265a49bad3cf&tipo=modf&email=prueba1@prueba.com&sourcealta=app1&fnacimiento=1992-01-12&cp=08240&provincia=Madrid&cod_pais=ESP&ip=85.48.99.18&aid=6D92078A-8246-4BA4-AE5B-76104861E7DC&campoExtra1=campoextra1&campoExtra2=campoextra2

Ejemplo Campos Extras desde app movil --> http://static.mobeleader.com/webservices/users.php?hash=8265a49bad3cf&tipo=modf&email=prueba1@prueba.com&sourcealta=app1&nombre=MiNombre&apellidos=MiApellido&fnacimiento=1992-01-12&cp=08240&telefono=456255456&provincia=Madrid&cod_pais=ESP&ip=85.48.99.18&aid=6D92078A-8246-4BA4-AE5B-76104861E7DC&latitud=43.2956&longitud=-2.9973&terminaltipo=movil&terminalso=android&terminalsoversion=5.1.1&terminalmarca=Sony&terminalmodelo=Xperia S&terminalmodelocod=E2303&termnialpantallapulgadas=5.2&terminalpantallaresolucionaancho=720&terminalpantallaresolucionaalto=1184&terminalpantallappi=320&terminalpantallapxratio=1.500&terminaloperadorcodigo=21401&terminaloperadorpais=ES&terminaloperadornombre=Vodafone ES&appbundle=com.prueba.pr&appversion=1.22&appversioncode=19

Es posible combinar campos extra, opcionales y borrado de campos en una misma URL.

Bajas

Para dar de baja un nuevo registro en cualquier base de datos suya, necesitara tener creada su Base de Datos en el Panel de Mobeleader.

URL

La url a la que tienen que ir todas las bajas es http://static.mobeleader.com/webservices/users.php y mediante GET se le pasaran todas las variables.

Variables

  • Obligatorias:
    • hash: Contendrá el hash que le demos al cliente para saber a que BD pertenece de mailing pertenece el usuario o la baja.
    • tipo: en el caso de las bajas siempre va a contener la palabra 'baja'
    • email: El email a dar de alta o de baja

Ejemplos

http://static.mobeleader.com/webservices/users.php?hash=8265a49bad3cf&tipo=baja&email=prueba1@prueba.com

http://static.mobeleader.com/webservices/users.php?hash=8265a49bad3cf&tipo=baja&email=prueba2@prueba.com

Obtenido de «https://wiki.mobeleader.com/index.php?title=BBDDs:AltasYBajas&oldid=2675»