1.1. Introducción
La API de Simpoll conecta tu sitio web con cualquier encuesta de Simpoll de varias formas. Su función principal es enviar los resultados de la encuesta a tu sitio para que los proceses.
Con la API puedes:
- relacionar a los encuestados con los visitantes de tu sitio;
- saber qué visitantes completaron la encuesta;
- saber cómo le fue a un visitante en un cuestionario (si lo aprobó o no);
- obtener las respuestas que dio un visitante en la encuesta.
1.2. Esquema de funcionamiento
El proceso es así:
- Al insertar una encuesta en tu sitio, puedes pasarle cualquier parámetro adicional (por ejemplo, un ID de usuario);
- El usuario completa la encuesta en el marco de Simpoll;
- Al terminar la encuesta, Simpoll llama a la URL de resultados de tu sitio y devuelve los parámetros que recibió de ti (si los hay);
- Junto con tus parámetros, Simpoll envía los resultados de la encuesta a la URL de resultados.
Así, además de entregar resultados, una encuesta puede actuar como «proxy» de cualquiera de tus datos.
Los parámetros se pueden enviar a la URL de resultados de una de tres formas:
Método POST
Los datos se envían en segundo plano, sin que el usuario lo vea y sin pasar por su navegador. La petición se envía cuando el usuario pulsa «Enviar» en la última página de la encuesta.
Método GET
El navegador del usuario se redirige desde la última página de la encuesta a la URL de resultados con los datos añadidos como parámetros GET. En este modo se ignora el ajuste «Redirección tras la encuesta».
Llamada a una función JavaScript de tu página
Tus parámetros y los resultados de la encuesta se pasan a una función JavaScript de la página donde está insertada la encuesta. La función tiene un nombre fijo y un argumento: un objeto con tus parámetros y los resultados de la encuesta.
Este método funciona en todos los navegadores modernos.
1.3. Seguridad en la transferencia de datos
La API de Simpoll puede firmar los datos que recibe y envía. Las firmas son opcionales, pero garantizan que nadie modifique los datos por el camino.