Migración desde v2

Aprenda a migrar de forma segura de la API v2 a v3

Migración de v2 a v3

SurveyNinja API v3 es la versión principal actual. Esta sección ayuda a los desarrolladores que ya usan API v2 a migrar de forma segura a v3 y comprender qué ha cambiado.

La tabla completa de cambios y todos los ejemplos se encuentran en la sección ## Migration from v2 to v3 del archivo api_v3.md .

Cambios principales

  • Nueva URL base:
    /api/v2/service → /api/v3/service
  • GET /quiz (lista de encuestas): v3 añade carpetas y campos adicionales en la respuesta.
  • Paginación: se cambió a los parámetros estándar page / per_page para la mayoría de los endpoints.
  • Nuevos endpoints: /user.
  • Nuevos endpoints de exportación e informes: exportación de respuestas e informes a CSV/XLSX/PDF/Word, datos adicionales de informes y enlaces de informes públicos.

Pasos prácticos de migración

  1. Actualiza la URL base de /api/v2/service a /api/v3/service.
  2. Comprueba qué endpoints de v2 usas y encuentra sus equivalentes en v3 en la documentación (encuestas, respuestas e informes primero).
  3. Si usabas paginación, cambia a los parámetros page / per_page donde sea necesario.
  4. Comienza a usar las nuevas funcionalidades según las necesites: códigos promocionales, exportación, datos adicionales de informes, integraciones.
  5. Guarda un enlace a la documentación archivada de v2 si necesitas tiempo para una migración gradual.

El archivo API_V2_ARCHIVE.md contiene un breve resumen de v2, y api_v3.md contiene la lista completa de endpoints de v3 y un mapeo de los escenarios clave.