Ajustes de Desarrollador

La página de Ajustes de Desarrollador es donde gestionas el acceso programático a tu cuenta de QuestionPro. La API de QuestionPro es una forma de conectar aplicaciones externas a QuestionPro.

• API: Gestiona tu clave de API y revisa un registro de las llamadas a la API realizadas con ella.

• Inicia sesión en tu cuenta de QuestionPro.
• Haz clic en tu ícono de perfil y ve a Mi Cuenta.
• Haz clic en la pestaña Ajustes de Desarrollador.
• Bajo la pestaña API podrás acceder a tu clave de API de QuestionPro.

La API de QuestionPro te permite conectar tu cuenta de QuestionPro a otras aplicaciones y scripts. Puedes usarla para recuperar encuestas y respuestas, gestionar usuarios y automatizar tareas sin iniciar sesión en la plataforma. Cada solicitud de API se autentica con una clave de API que es única para tu cuenta de usuario.

La pestaña API es donde activas o desactivas el acceso a la API, gestionas tu clave de API y revisas un registro de cada llamada a la API realizada con tu clave.

Una clave de API es una cadena única que te identifica cuando tu aplicación llama a la API de QuestionPro. Cada clave pertenece a un usuario individual de QuestionPro, y solo se permite una clave por usuario.

Usa el interruptor Estado en la parte superior de la pestaña API.

• Activo: Se aceptan las solicitudes de API realizadas con tu clave.
• Inactivo: No se procesan las solicitudes de API realizadas con tu clave. Tu clave no se elimina, por lo que puedes volver a activar en cualquier momento.

Para cambiar el estado:

• Ve a Mi Cuenta >> Ajustes de Desarrollador >> API.
• Bajo Estado, haz clic en Activo o Inactivo.

Por seguridad, tu clave de API está enmascarada de forma predeterminada.

• Haz clic en el ícono de ojo en el campo de la clave de API para mostrar u ocultar la clave.
• Haz clic en el ícono de copiar para copiar la clave en tu portapapeles.

Si tu clave ha sido expuesta, o quieres rotarla como práctica de seguridad, puedes generar una nueva.

• Ve a Mi Cuenta >> Ajustes de Desarrollador >> API.
• Haz clic en Regenerar clave de API.
• Confirma cuando se te pida.
• Copia tu nueva clave y actualízala en cada aplicación o script que la use.

La sección Registros de la pestaña API lista las llamadas a la API realizadas con tu clave. Úsala para auditar la actividad, confirmar que una integración está funcionando y resolver errores. Total de llamadas de API en la parte superior de la sección muestra el número de llamadas en el rango de fechas seleccionado.

La tabla de registros incluye las siguientes columnas:

• ID: ID único de la llamada a la API. Haz clic en el ID para ver los detalles de esa llamada.
• Marca de tiempo: Fecha y hora en que se realizó la llamada.
• Dirección IP: Dirección IP de donde provino la solicitud.
• URL de API: El endpoint que se llamó, por ejemplo https://api.questionpro.com/a/api/v2/surveys/{surveyID}.
• Estado de respuesta: El código de estado HTTP devuelto para la llamada.

Para una lista de códigos de respuesta y error y sus significados, consulta la sección Códigos de Error de la documentación de la API de QuestionPro.

Escribe una URL de API completa o parcial o un ID de registro en la caja Buscar por URL de API o ID de registro. La tabla se filtra a medida que escribes.

• Haz clic en el selector de rango de fechas, que muestra los últimos 30 días por defecto.
• Elige una fecha de inicio y una fecha de finalización.
• La tabla de registros y el conteo de Total de llamadas de API se actualizan para mostrar solo las llamadas en ese rango.

• Establece el rango de fechas que deseas exportar.
• Haz clic en Exportar Registros de API.

Encuentra la llamada en la tabla Registros y verifica su Estado de Respuesta. Cualquier estado diferente a 2xx significa que la solicitud no se completó con éxito. Haz clic en el ID de la llamada para ver más detalles, y usa la caja de búsqueda para encontrar un endpoint o ID de encuesta específico.

Verifica estas causas comunes:

• El estado de la API está configurado en Inactivo.
• La clave de API fue regenerada y la integración todavía está usando la clave antigua.
• La encuesta o el ID de usuario solicitado no existe o no está disponible para ti (404).

• Nunca compartas tu clave públicamente o la incluyas en repositorios de código fuente.
• Almacénala en variables de entorno o un gestor de secretos.
• Regenerala periódicamente e inmediatamente si sospechas que ha sido expuesta.
• Revisa los registros regularmente en busca de direcciones IP desconocidas o endpoints inesperados.
• Establece el estado en Inactivo cuando no estés utilizando integraciones de API.