Ir al contenido

Registro de cambios de la API

Esta página enumera los cambios de la API de Pristo que afectan a tu integración, del más reciente al más antiguo. La referencia de la API (en inglés) siempre describe la API actual; esta página indica qué cambió y cuándo.

La API tiene una sola versión, v1, en https://api.pristo.io. Un cambio que rompería las llamadas existentes mantiene en funcionamiento el comportamiento anterior y aparece aquí primero.

La referencia de la API de este sitio reemplaza las antiguas páginas para desarrolladores. Describe la API tal como se publicó el 11 de octubre de 2026. Si hiciste tu integración con las páginas antiguas, revisa estas diferencias:

  • La URL base es https://api.pristo.io.
  • Las claves API se crean en la aplicación de Pristo CX. Consulta Autenticarse con una clave API.
  • La API tiene dos operaciones: enviar un evento y generar un enlace de encuesta. No hay ningún endpoint que guarde o lea contactos o respuestas.
  • El campo language de un enlace de encuesta solo define el idioma de las páginas de enlace caducado y de agradecimiento de ese enlace. El cuestionario se abre en su idioma principal.
  • Una clave API que falta o que no se reconoce devuelve 401 con un cuerpo de problema JSON. Los demás errores se enumeran en Errores de la API.
  • Cada clave API pertenece a un programa: el programa que estaba activo en la aplicación cuando se creó la clave. Las claves creadas antes se asignaron al primer programa de la cuenta.
  • POST /v1/events/send encuentra la población a partir del programa de la clave. La ruta anterior POST /v1/events/send/{popId} sigue funcionando y hace lo mismo; su popId se ignora. Usa /v1/events/send en el código nuevo.
  • El acceso a la API forma parte de los planes Estándar y Pro. Crear, activar o cambiar el nombre de una clave en otro plan devuelve 403. Desactivar y eliminar una clave siempre funciona.
  • Una cuenta puede tener hasta 10 claves API activas.
  • Se revocaron las claves que se habían creado antes de esta regla en un plan sin acceso a la API.