API: resolución de problemas y preguntas frecuentes

Si eres desarrollador/a y estás usando nuestras API para crear formularios y acceder a tus resultados, aquí encontrarás respuesta a algunas de las preguntas más frecuentes, así como consejos para resolver ciertos problemas técnicos. Sigue leyendo si quieres saber más.

- ¿Puedo modificar una sola pregunta sin tener que utilizar la estructura de todo el formulario?

- ¿Puedo utilizar la API Response para solicitar una página concreta de los resultados paginados?

- ¿Puedo crear enlaces públicos a los archivos cargados a través de preguntas de tipo "subida de archivo"?

- ¿Puedo hacer que los títulos de las preguntas aparezcan en la carga útil de respuestas?

- ¿Están incluidos los campos correspondientes a cálculos (como las variables "price" o "score") en la API Responses?

- ¿Cómo puedo ver los campos de referencia personalizada correspondientes a las opciones de respuesta en las preguntas de tipo "elección múltiple"?

- ¿Por qué el número de respuestas que se indica en la API es distinto al que aparece en el panel "Resultados" de mi cuenta de Typeform?

- ¿Por qué aparece un valor nulo ("null") en la carga útil de la API Responses?

- ¿Por qué me sale un error CORS cuando uso la API?

- Cuando actualizo mi formulario a través de la API, me sale un código de estado "2xx", pero, al entrar en mi cuenta, los cambios no aparecen reflejados en el panel "Crear". ¿Cuál es el problema?

¿Puedo modificar una sola pregunta sin tener que utilizar la estructura de todo el formulario?

Lamentablemente, no tenemos disponible ningún punto final que permita realizar cambios en una sola pregunta o en un solo campo de un formulario. 

Los creadores deberán utilizar la carga útil correspondiente a la estructura de todo el formulario (a la que podrán tener acceso realizando una solicitud a nuestra API de obtención del formulario), modificar los campos que quieran y, luego, enviar la nueva carga útil, en su totalidad, a nuestra API de actualización del formulario.

¿Puedo utilizar la API Responses para solicitar una página concreta de los resultados paginados?

Haciendo una solicitud a nuestra API de obtención de respuestas, puedes obtener todas las respuestas a la vez (hasta un máximo de 1000 respuestas) o bien utilizar los parámetros de consulta "desde/hasta" o "antes/después" para acotar el rango de tu solicitud.

¿Puedo crear enlaces públicos a los archivos cargados a través de preguntas de tipo "subida de archivo"?

No. Actualmente, no ofrecemos la posibilidad de crear enlaces de acceso público que puedan compartirse con terceros para acceder a los archivos subidos por los usuarios. 

Los enlaces a estos archivos siempre requerirán una autenticación a través de la API de nuestra página web, salvo que se utilicen en una integración o en un archivo exportado. Puedes descargarte todos los archivos que te hayan enviado los usuarios o bien exportar todas las respuestas que haya recibido tu formulario (incluidos los enlaces públicos que se creen durante la exportación). Otra opción es utilizar una integración, como la de hojas de cálculo de Google, para generar enlaces públicos.

Puedes usar nuestra API para obtener este archivo, pero tendrás que guardarlo primero en tu aplicación y, después, crear un enlace público desde ese nuevo archivo. 

¿Puedo hacer que los títulos de las preguntas aparezcan en la carga útil de respuestas?

Sí, puedes usar la función "referencias de bloques" para editar el identificador único asociado al título de cada una de tus preguntas para facilitar su consulta. De esta forma, los títulos de tus preguntas aparecerán también en la carga útil de respuestas.

¿Están incluidos los campos correspondientes a cálculos (como las variables "price" o "score") en la API Responses?

Sí, están incluidos. Si quieres saber más sobre este tema, consulta el apartado "Retrieve responses" (en inglés) en la documentación relativa a nuestras API. Encontrarás un ejemplo de respuesta justo al final del apartado. 

¿Cómo puedo ver los campos de referencia personalizada correspondientes a las opciones de respuesta en las preguntas de tipo "elección múltiple"?

Lamentablemente, ni nuestra API Responses ni nuestra API Webhooks incluyen las referencias asociadas a cada opción de respuesta en el objeto "respuestas de elección múltiple". Solo se incluye la referencia relativa a la pregunta.

¿Por qué el número de respuestas que se indica en la API es distinto al que aparece en el panel "Resultados" de mi cuenta de Typeform?

Uno de los motivos por los que es posible que el número de respuestas que se indica en nuestra API sea distinto al que aparece en el panel "Resultados" es que hayas realizado una solicitud a nuestra API con los filtros relativos a la fecha y la hora configurados de la siguiente manera:

forms/OM1YKa/responses?sort=submitted_at,asc&page_size=1000

&until=2020-03-03T00%3A00%3A00&since=2020-03-02T00%3A00%3A00

Esto ocurre porque la fecha y la hora que se envían a la API se expresan en el formato correspondiente a la zona horaria UTC, mientras que el panel "Resultados" enviará los datos en el huso horario que tengas configurado en tu dispositivo.

Si quieres que los resultados que recibas coincidan con la información que aparece en el panel "Resultados", tendrás que calcular la diferencia entre ambos husos horarios cuando vayas a realizar una solicitud a nuestra API.

¿Por qué aparece un valor nulo ("null") en la carga útil de la API Responses?

Esto puede ocurrir cuando se añaden a la solicitud ciertos parámetros relativos a un campo específico, pero la pregunta no ha sido respondida por el usuario.

Por defecto, nuestra API de obtención de respuestas solo incluye las respuestas a aquellas preguntas que han sido respondidas. Es decir, que si una pregunta no tiene respuesta, esa pregunta se omitirá y no aparecerá en la carga útil.

Como puedes ver aquí, si añades un parámetro de campo en una pregunta concreta, verás que aparece un valor nulo ("null") cuando recibas las respuestas.

¿Por qué me sale un error CORS cuando uso la API?

Nuestras API no admiten solicitudes realizadas desde el lado del cliente de tu aplicación. Tendrás que realizar tus solicitudes desde el lado del servidor de tu aplicación. Encontrarás más información sobre el error CORS en este mensaje de nuestra Comunidad.

Cuando actualizo mi formulario a través de la API, me sale un código de estado "2xx", pero, al entrar en mi cuenta, los cambios no aparecen reflejados en el panel "Crear". ¿Cuál es el problema?

Esto puede ocurrir si estás trabajando en el creador de formularios con un borrador que no ha sido publicado aún (verás que el botón "Publicar" aparece destacado en color negro).

Si este es tu caso, puedes pulsar el botón "Publicar" en el panel "Crear". Esto hará que se sobrescriba el archivo y anulará cualquier cambio anterior que hayas intentado hacer a través de la API. Después, ya podrás realizar una nueva petición a la API con las actualizaciones que quieras introducir en tu formulario.

También puedes ponerte en contacto con el equipo de Atención al cliente para que te ayude a eliminar el borrador sin publicar del creador de formularios.