El servicio de monitoreo de visitas, es un servicio web que debe llamarse vía POST. Para utilizar el servicio simplemente debe invocarse el siguiente recurso:
http://unetoolsback.circuloempresariosune.com/visitas/pub_guardar
Los parámetros que deben pasarse en cada llamado se detallan en la siguiente tabla:
| Parámetro | Nombre de la variable POST | Descripción | Ejemplo |
|---|---|---|---|
| URL Completa | data[Visita][url_completa] | La URL que está visitando el usuario. Incluye querystrings y parámetros tal cual como se visualiza en el navegador | www.yogadigital.net?params=7pntvnxwnih1sbx2mfyt |
| Dominio | data[Visita][dominio] | El dominio web de la URL visitada | yogadigital.net |
| IP Visitante | data[Visita][ip_visitante] | La dirección IP del navegador | 114.52.101.216 |
| User Agent | data[Visita][user_agent] | El String que identifica el Navegador del Usuario. Para más información de los user agents, visitar la siguiente dirección | Mozilla/5.0 (Windows; U; Windows NT 6.1; tr-TR) AppleWebKit/533.20.25 (KHTML, like Gecko) Version/5.0.4 Safari/533.20.27 |
| Navegador | data[Visita][navegador] | El tipo de instalación del Toolbar. Únicamente existen dos opciones para este campo puesto que sólamente existen versiones para Internet Explorer y Firefox. Los posibles valores son: firefox o ie. Tenga en cuenta que el valor de la cadena debe ser enviado en minúsculas | firefox |
| Versión del navegador | data[Visita][version] | La versión del navegador utilizado. Por ejemplo, para el navegador Firefox 4, el valor de éste campo sería 4 | 4 |
| Sistema Operativo | data[Visita][sistema_operativo] | La cadena que identifica el sistema operativo del usuario. La cadena debe llegar en minúsculas | windows |
| Resolución | data[Visita][resolucion] | La resolución de pantalla del usuario. Aquí debe pasarse una cadena que indica la resolución tal cual como se ve en el sistema. La cadena debe llegar en minúsculas | 1024x768 |
El servicio retorna 2 tipos de respuesta que vienen en el HEAD del documento HTML. Las posibles respuestas se detallan en la siguiente tabla:
| Respuesta | Descripcion |
|---|---|
| HTTP/1.1 200 OK Status: 200 OK |
El registro fue guardado en la base de datos correctamente. |
| HTTP/1.1 202 Accepted Status: 202 Accepted |
Hubo un error y el registro no fue guardado en la base de datos. Esta situación puede darse por que los parámetros están incompletos o mal nombrados. Revise la sección de TIPS para más información. |
Para validar el código HTTP de respuesta, utilice el Charles HTTP Debugger