Documentación Webservice NickCenter - Historial de revisiones

Deneb: /* Campos y Formatos */

2019-06-07T10:31:34Z

Campos y Formatos

Deneb: /* Llamadas al Webservice */

2019-06-07T10:29:41Z

Llamadas al Webservice

Deneb: /* Llamadas al Webservice */

2019-06-07T10:27:54Z

Llamadas al Webservice

← Revisión anterior		Revisión del 12:27 7 jun 2019
Línea 63:		Línea 63:
	''Recuerde reemplazar el contenido de los ejemplos por los valores reales''.		''Recuerde reemplazar el contenido de los ejemplos por los valores reales''.
	*'''checkActive:''' Esta tarea comprobará que la aplicación tenga NickCenter activo, independientemente de usarla directamente o no, el resto de tareas harán uso de ella antes de realizar sus operaciones propias.		*'''checkActive:''' Esta tarea comprobará que la aplicación tenga NickCenter activo, independientemente de usarla directamente o no, el resto de tareas harán uso de ella antes de realizar sus operaciones propias.
	:*'''app:''' Contendrá el hash de la aplicación dada de alta en el panel ~~de Mobeleader~~.		:*'''app:''' Contendrá el hash de la aplicación dada de alta en nuestro panel.
	:*'''country:''' Contendrá el país del dispositivo, necesario para comprobar si NickCenter esta activo para esa aplicación en ese país.		:*'''country:''' Contendrá el país del dispositivo, necesario para comprobar si NickCenter esta activo para esa aplicación en ese país.
	:*''Ejemplo llamada directa:''		:*''Ejemplo llamada directa:''

Deneb: /* Conexión con el Webservice */

2019-06-07T10:26:44Z

Conexión con el Webservice

← Revisión anterior		Revisión del 12:26 7 jun 2019
Línea 7:		Línea 7:
	La conexión con el Webservice se puede realizar de dos maneras:		La conexión con el Webservice se puede realizar de dos maneras:
	#Mediante llamada directa al Webservice. Esta opción será menos segura debido a que los datos de la petición irán sin cifrar.		#Mediante llamada directa al Webservice. Esta opción será menos segura debido a que los datos de la petición irán sin cifrar.
	#Usando la clase '''spsApiConnection''' ~~creada por Mobeleader~~. Esta opción será mas segura ya que cuenta con un cifrado mediante claves RSA generadas en nuestro sistema.		#Usando la clase '''spsApiConnection'''. Esta opción será mas segura ya que cuenta con un cifrado mediante claves RSA generadas en nuestro sistema.

	==Llamada directa==		==Llamada directa==

Deneb: /* Introduccion */

2019-06-07T10:26:02Z

Introduccion

← Revisión anterior		Revisión del 12:26 7 jun 2019
Línea 1:		Línea 1:
	=Introduccion=		=Introduccion=
	En ésta documentación se expondrá como deberemos hacer uso del Webservice de NickCenter, de manera que emule la propia librería de NickCenter y así no haya la necesidad de usarla ni implementarla en las aplicaciones. A pesar de ello, la configuración en el panel ~~de Mobeleader~~ será la misma, siendo necesario dar de alta la aplicación en éste, y configurandola para el uso de NickCenter. Podremos hacer uso de dicho Webservice de dos maneras:		En ésta documentación se expondrá como deberemos hacer uso del Webservice de NickCenter, de manera que emule la propia librería de NickCenter y así no haya la necesidad de usarla ni implementarla en las aplicaciones. A pesar de ello, la configuración en nuestro panel será la misma, siendo necesario dar de alta la aplicación en éste, y configurandola para el uso de NickCenter. Podremos hacer uso de dicho Webservice de dos maneras:
	#Llamada directa al Webservice. Ésta opción será menos segura debido a que los datos irán sin cifrar.		#Llamada directa al Webservice. Ésta opción será menos segura debido a que los datos irán sin cifrar.
	#Usando la clase '''spsApiNickcenter''' ~~creada por Mobeleader~~. Esta opción será mas segura ya que cuenta con un cifrado mediante RSA Keys generadas en nuestro sistema.		#Usando la clase '''spsApiNickcenter'''. Esta opción será mas segura ya que cuenta con un cifrado mediante RSA Keys generadas en nuestro sistema.

	=Conexión con el Webservice=		=Conexión con el Webservice=

Deneb: /* Clase spsApiConnection */

2019-06-07T10:24:50Z

Clase spsApiConnection

← Revisión anterior		Revisión del 12:24 7 jun 2019
Línea 33:		Línea 33:
	</source>		</source>
	<br/>		<br/>
	Una vez modificada la ruta, para poder instanciar la clase deberemos coger la cadena de la '''RSA KEY Privada''', accesible desde https://panel.mobeleader.com/index.php?sec=6, y reemplazarla en el siguiente codigo.		Una vez modificada la ruta, para poder instanciar la clase deberemos coger la cadena de la '''RSA KEY Privada''', accesible desde [https://panel.mobeleader.com/index.php?sec=6 nuestro panel], y reemplazarla en el siguiente codigo.
	<br/>		<br/>
	<source lang="PHP">		<source lang="PHP">

Deneb: /* Clase spsApiConnection */

2019-01-24T10:27:48Z

Clase spsApiConnection

← Revisión anterior		Revisión del 12:27 24 ene 2019
Línea 36:		Línea 36:
	<br/>		<br/>
	<source lang="PHP">		<source lang="PHP">
			require_once "PATH..../api_connection_class.php";
	$conexionapi = new spsApiConnection([RSA KEY PRIVADA]);		$conexionapi = new spsApiConnection([RSA KEY PRIVADA]);
	</source>		</source>
Línea 42:		Línea 43:
	<br/>		<br/>
	<source lang="PHP">		<source lang="PHP">
			require_once "PATH..../api_connection_class.php";
	$conexionapi = new spsApiConnection([RSA KEY PRIVADA]);		$conexionapi = new spsApiConnection([RSA KEY PRIVADA]);
	$json_datos_devueltos = $conexionapi->getWebserviceData(tarea, array_datos)		$json_datos_devueltos = $conexionapi->getWebserviceData(tarea, array_datos)

Deneb: /* Tareas */

2019-01-16T18:18:15Z

Tareas

← Revisión anterior		Revisión del 20:18 16 ene 2019
Línea 49:		Línea 49:

	=Tareas=		=Tareas=
	La clase '''~~spsApiNickcenter~~''' consta de la función ''getData('''tarea, array_datos''')'', con la que ejecutaremos las distintas operaciones que el Webservice permite y a la que le deberemos mandar los siguientes parámetros:		La clase '''spsApiConnection''' consta de la función ''getData('''tarea, array_datos''')'', con la que ejecutaremos las distintas operaciones que el Webservice permite y a la que le deberemos mandar los siguientes parámetros:
	#'''tarea:''' Sera la propia tarea a realizar, puediendo ser:		#'''tarea:''' Sera la propia tarea a realizar, puediendo ser:
	##'''checkActive'''.		##'''checkActive'''.

Deneb: /* Conexión con el Webservice */

2019-01-16T18:15:27Z

Conexión con el Webservice

← Revisión anterior		Revisión del 20:15 16 ene 2019
Línea 5:		Línea 5:

	=Conexión con el Webservice=		=Conexión con el Webservice=
	~~kakakak~~		La conexión con el Webservice se puede realizar de dos maneras:
			#Mediante llamada directa al Webservice. Esta opción será menos segura debido a que los datos de la petición irán sin cifrar.
			#Usando la clase '''spsApiConnection''' creada por Mobeleader. Esta opción será mas segura ya que cuenta con un cifrado mediante claves RSA generadas en nuestro sistema.

	==Llamada directa==		==Llamada directa==

Deneb: /* Llamada directa */

2019-01-16T18:14:13Z

Llamada directa

← Revisión anterior		Revisión del 20:14 16 ene 2019
Línea 9:		Línea 9:
	==Llamada directa==		==Llamada directa==
	Si queremos usar directamente el Webservice de Nickcenter sin la necesidad de usar la clase '''analyticsConnection''', esta será la URL a la que deberemos conectarnos mediante POST ''https://nickcenter.mobeleader.com/webservice_nickcenter.php?data=''. Más adelante se expondrán que tareas hay disponibles y como hay que mandar los datos para su ejecución.		Si queremos usar directamente el Webservice de Nickcenter sin la necesidad de usar la clase '''analyticsConnection''', esta será la URL a la que deberemos conectarnos mediante POST ''https://nickcenter.mobeleader.com/webservice_nickcenter.php?data=''. Más adelante se expondrán que tareas hay disponibles y como hay que mandar los datos para su ejecución.
	:*''Ejemplo de petición directa con task (tarea) checkActive, una app concreta (añadiendo el hash que le correspondiera) y country (país) ES (España):''		:*''Ejemplo de petición directa con task (tarea) '''checkActive''', una app concreta (añadiendo el hash que le correspondiera) y country (país) '''ES''' (España):''
	<source lang="PHP">		<source lang="PHP">
	$url = 'https://nickcenter.mobeleader.com/webservice_nickcenter.php';		$url = 'https://nickcenter.mobeleader.com/webservice_nickcenter.php';

← Revisión anterior		Revisión del 12:31 7 jun 2019
Línea 267:		Línea 267:
	<br/><br/>		<br/><br/>
	*'''jsonUser:'''		*'''jsonUser:'''
	**'''name:''' Nombre del usuario. Máximo 100 caracteres. ''Ejemplo: ~~Kevin~~''.		**'''name:''' Nombre del usuario. Máximo 100 caracteres. ''Ejemplo: John''.
	**'''surname:''' Apellido del usuario. Máximo 100 caracteres. ''Ejemplo: ~~Lancharro~~''.		**'''surname:''' Apellido del usuario. Máximo 100 caracteres. ''Ejemplo: Smith''.
	**'''email:''' Email del usuario. Máximo 250 caracteres. ''Ejemplo: xxxx@xxx.com''.		**'''email:''' Email del usuario. Máximo 250 caracteres. ''Ejemplo: xxxx@xxx.com''.
	**'''password:''' Password del usuario. Deberá ir en md5(). Máximo 50 caracteres. ''Ejemplo: e10adc3949ba59abbe56e057f20f883e''.		**'''password:''' Password del usuario. Deberá ir en md5(). Máximo 50 caracteres. ''Ejemplo: e10adc3949ba59abbe56e057f20f883e''.
Línea 289:		Línea 289:
	<br/><br/>		<br/><br/>
	*'''jsonApp''': Todos los campos son obligatorios		*'''jsonApp''': Todos los campos son obligatorios
	**'''name''': Nombre de la aplicación dada de alta en el panel ~~de Mobeleader~~. ''Ejemplo: ~~Mobeleader~~''.		**'''name''': Nombre de la aplicación dada de alta en nuestro panel. ''Ejemplo: MyApp''.
	**'''bundle''': Nombre del paquete de la aplicación. ''Ejemplo: com.~~mobeleader~~''.		**'''bundle''': Nombre del paquete de la aplicación. ''Ejemplo: com.mypackage''.
	**'''version''': Version de la aplicación. ''Ejemplo: 1.0''.		**'''version''': Version de la aplicación. ''Ejemplo: 1.0''.
	**'''versioncode''': Código de versión de la aplicación. ''Ejemplo: 1''.		**'''versioncode''': Código de versión de la aplicación. ''Ejemplo: 1''.

← Revisión anterior		Revisión del 12:29 7 jun 2019
Línea 80:		Línea 80:
	<br/>		<br/>
	*'''requestFields:''' Mediante ésta tarea obtendremos la configuración de campos y traducciones para una determinada vista.		*'''requestFields:''' Mediante ésta tarea obtendremos la configuración de campos y traducciones para una determinada vista.
	**'''app:''' Contendrá el hash de la aplicación dada de alta en el panel ~~de Mobeleader~~.		**'''app:''' Contendrá el hash de la aplicación dada de alta en nuestro panel.
	**'''view:''' Indicará los campos de que vista solicitamos.		**'''view:''' Indicará los campos de que vista solicitamos.
	***'''register:''' Pantalla inicial del registro.		***'''register:''' Pantalla inicial del registro.
Línea 104:		Línea 104:
	<br/>		<br/>
	*'''register:''' Esta tarea servirá para registrar un usuario en nuestro sistema.		*'''register:''' Esta tarea servirá para registrar un usuario en nuestro sistema.
	**'''app:''' Contendrá el hash de la aplicación dada de alta en el panel ~~de Mobeleader~~.		**'''app:''' Contendrá el hash de la aplicación dada de alta en nuestro panel.
	**'''jsonDevice:''' Contendrá los datos del dispositivo. Más adelante se exponen que campos son obligatorios.		**'''jsonDevice:''' Contendrá los datos del dispositivo. Más adelante se exponen que campos son obligatorios.
	**'''jsonApp:''' Contendrá los datos de la aplicación. Más adelante se exponen que campos son obligatorios.		**'''jsonApp:''' Contendrá los datos de la aplicación. Más adelante se exponen que campos son obligatorios.
Línea 125:		Línea 125:
	<br/>		<br/>
	*'''update:''' Esta tarea servirá para actualizar un usuario que previamente haya sido registrado en nuestro sistema.		*'''update:''' Esta tarea servirá para actualizar un usuario que previamente haya sido registrado en nuestro sistema.
	**'''app:''' Contendrá el hash de la aplicación dada de alta en el panel ~~de Mobeleader~~.		**'''app:''' Contendrá el hash de la aplicación dada de alta en nuestro panel.
	**'''jsonDevice:''' Contendrá los datos del dispositivo. Más adelante se exponen que campos son obligatorios.		**'''jsonDevice:''' Contendrá los datos del dispositivo. Más adelante se exponen que campos son obligatorios.
	**'''jsonApp:''' Contendrá los datos de la aplicación. Más adelante se exponen que campos son obligatorios.		**'''jsonApp:''' Contendrá los datos de la aplicación. Más adelante se exponen que campos son obligatorios.
Línea 146:		Línea 146:
	<br/>		<br/>
	*'''login:''' Esta tarea servirá para hacer login en las aplicaciones registradas en NickCenter, con usuarios previamente registrados en nuestro sistema.		*'''login:''' Esta tarea servirá para hacer login en las aplicaciones registradas en NickCenter, con usuarios previamente registrados en nuestro sistema.
	**'''app:''' Contendrá el hash de la aplicación dada de alta el panel ~~de en Mobeleader~~.		**'''app:''' Contendrá el hash de la aplicación dada de alta en nuestro panel.
	**'''jsonDevice:''' Contendrá los datos del dispositivo. Más adelante se exponen que campos son obligatorios.		**'''jsonDevice:''' Contendrá los datos del dispositivo. Más adelante se exponen que campos son obligatorios.
	**'''jsonApp:''' Contendrá los datos de la aplicación. Más adelante se exponen que campos son obligatorios.		**'''jsonApp:''' Contendrá los datos de la aplicación. Más adelante se exponen que campos son obligatorios.
Línea 167:		Línea 167:
	<br/>		<br/>
	*'''rescuePassword:''' Mediante ésta tarea restauraremos la contraseña de usuarios previamente registrados en nuestro sistema y que no esten dados de baja.		*'''rescuePassword:''' Mediante ésta tarea restauraremos la contraseña de usuarios previamente registrados en nuestro sistema y que no esten dados de baja.
	**'''app:''' Contendrá el hash de la aplicación dada de alta el panel ~~de en Mobeleader~~.		**'''app:''' Contendrá el hash de la aplicación dada de alta en nuestro panel.
	**'''country:''' Contendrá el país del dispositivo, necesario para comprobar si NickCenter esta activo para esa aplicación en ese país.		**'''country:''' Contendrá el país del dispositivo, necesario para comprobar si NickCenter esta activo para esa aplicación en ese país.
	**'''language:''' Idioma del dispositivo, necesario para las traducciones que se retornarán.		**'''language:''' Idioma del dispositivo, necesario para las traducciones que se retornarán.