Skip to main content
Cada estudio tiene un estudio de prueba: una copia de su configuración, poblada con personas y reservas de ejemplo. Una clave crq_test_ lee de él; una clave crq_live_, del estudio real. Las rutas, los permisos y las respuestas son los mismos en los dos. Úsalo para escribir y probar tu integración sin ver datos de clientes reales.

​
Qué tiene

La configuración del estudio real, copiada en el momento en que se preparó:
  • el nombre del estudio, con ” (prueba)” al final;
  • su zona horaria, su país y su moneda;
  • sus reglas de reserva;
  • sus sedes y salones;
  • sus disciplinas y sus clases activas, con su horario semanal;
  • sus packs, sus planes de membresía y sus ofertas de bienvenida.
Personas y movimientos de ejemplo:
  • tres instructores y dieciséis clientes ficticios;
  • sesiones desde una semana antes hasta dos semanas después del día en que se preparó;
  • reservas en esas sesiones: las pasadas con asistencia (y alguna ausencia), las futuras confirmadas, y una sesión llena con lista de espera;
  • algunos packs y membresías de clientes, con sus cuotas, un pago y una cuota vencida.
Lo que no se copia: los clientes, los instructores, las reservas y los pagos reales; las conexiones del estudio con otros servicios (WhatsApp, procesadores de pago, facturación electrónica, calendarios). Lo que no está en la primera lista no se copia.

​
No le escribe a nadie

El estudio de prueba no manda emails, ni WhatsApp, ni notificaciones, y no cobra nada:
  • sus personas tienen contactos ficticios: emails de example.com (un dominio reservado que no es de nadie) y teléfonos del rango ficticio +1 con central 555 y número del 0100 al 0199;
  • no tiene conectado ningún canal de mensajes ni ningún procesador de pago;
  • y, aunque algo intentara mandar un aviso, Craqui lo descarta para un estudio de prueba.
Una persona del estudio de prueba solo puede tener un contacto ficticio. Si una respuesta dice sandbox_contact_not_allowed o sandbox_account_reserved, es por esta regla.

​
livemode

Todo objeto que devuelve la API trae livemode: false si viene del estudio de prueba, true si viene del real. Si tu sistema guarda datos, guárdalo también: así nunca confundes un dato de prueba con uno real.

​
Se crea solo, y se restablece

El estudio de prueba se prepara la primera vez que la propietaria crea una clave de prueba. Para empezar de nuevo, ella aprieta Restablecer datos de prueba en Configuración → Integraciones → API, en la sección Datos de prueba. Restablecer prepara un estudio de prueba nuevo, con la configuración que el estudio real tiene en ese momento, y el anterior deja de estar disponible:
  • Todos los ids cambian, también el del negocio (biz_). Un id guardado de antes responde not_found.
  • Un cursor de antes responde invalid_cursor.
  • Las claves de prueba siguen funcionando: no hace falta crear otras.
Si una clave de prueba responde sandbox_unavailable, el estudio de prueba no está listo: restablecerlo lo arregla.

​
Prueba y producción no se cruzan

  • Una clave de prueba nunca lee datos reales, y una de producción nunca lee el estudio de prueba.
  • Un id del estudio real con una clave de prueba responde not_found, y al revés.
  • Un cursor de un entorno no sirve en el otro.
Los límites de pedidos, los permisos y el plan funcionan igual en los dos entornos: una clave de prueba de un estudio cuyo plan no incluye la API responde plan_required.

​
La propietaria ve tus pedidos

Cada pedido, de prueba o de producción, aparece en la actividad de la API del panel de la propietaria, con su request_id. Los de prueba llevan la etiqueta Prueba.