Empecemos
La integración de Survio con sus sistemas internos se puede realizar mediante API. Aquí hay una guía rápida para comenzar.
Survio proporciona una API para recuperar automáticamente datos de varios recursos. Dichos datos se pueden utilizar para un análisis posterior o la implementación del proceso. Puede, por ejemplo, enviar una encuesta de satisfacción a sus clientes y hacer que Survio envíe sus respuestas automáticamente en su CRM o cualquier herramienta de BI para monitorear y evaluar los datos. Esto le da a la gerencia de la empresa la oportunidad de tomar medidas rápidas y adecuadas, o planificar de manera consistente a largo plazo.
Survio API sigue el estándar Open API y el esquema está disponible para descargar.
Recursos
Actualmente, la API brinda acceso a un solo recurso: respuestas individuales.
Uso de la API
La solicitud a la API se realiza mediante el protocolo HTTP para alojar “https://api2.survio.com/v2/”. Sin embargo, para leer los datos, es necesario obtener credenciales.
Para ejecutar solicitudes, necesita autorización, que se realiza a través del token API. El token se envía en el encabezado HTTP. El formato de este tipo de encabezado es así:
Authorization: Bearer <token>
Un ejemplo de la solicitud para obtener respuestas se verá así:
Example request
El token se genera específicamente para su cuenta, por lo que solo puede acceder a los datos dentro de su cuenta. El token no tiene fecha de caducidad, pero se puede revocar mediante solicitud.
Para generar un token, comuníquese con nuestro servicio de atención al cliente.
Cualquier persona con el token puede acceder a los datos de su cuenta a través de la API en modo de solo lectura. Aunque no es posible eliminar o dañar los datos, le recomendamos que mantenga el token en un lugar seguro para evitar el uso indebido. Es posible desactivar el token actual en cualquier momento y generar uno nuevo, si es necesario.
Puede encontrar información más detallada sobre cada extremo de la API en la referencia.
Cada recurso contiene la URL, un método de solicitud, un esquema de solicitud y un esquema de respuesta.
Paginación y filtros
Cada recurso que enumera registros proporciona un máximo de 30 resultados por solicitud. Los resultados se organizan en orden descendente, comenzando con la última entrada. Si supera la cantidad de 30 resultados, puede utilizar un parámetro GET:
?page=<page number>para mostrar páginas individuales con resultados posteriores.
La numeración de páginas comienza con "0", lo que en la práctica significa que
“?page=0” displays the first page,
“?page=1” displays the second page,
“?page=2” displays the third page etc. until the request returns no result.
Cada recurso también permite la aplicación de varios filtros para especificar resultados. Puedes elegir entre
fecha → filtra los resultados por una fecha específica
from - to → filtra los resultados por un intervalo de tiempo definido
tiempo de finalización → filtra los resultados por la cantidad de tiempo necesario para completar la encuesta
Puede, por ejemplo, obtener un registro de las respuestas recibidas después de una fecha determinada utilizando el siguiente formato:
?submitted[after]=<time>
También es posible encadenar filtros para establecer un intervalo de tiempo específico, por ejemplo:
?submitted[after]=<time>&submitted[before]=<time>
Límites de tasa
El objetivo principal de los límites de velocidad es garantizar el funcionamiento confiable de la API, la disponibilidad constante de datos y la prevención del abuso de datos, para que tenga toda la información que necesita a su disposición en cualquier momento. Estos límites solo se refieren a la cantidad de 1.000 solicitudes HTTP por hora y usuario.
¿Tienes comentarios?
Antes de ir a la referencia de la API, apreciaremos cualquier comentario que nos ayude a mejorar la experiencia del usuario y el uso cómodo de la API de Survio. Si encuentra algún error o problema en la API, no dude en contactarnos.