Entornos de API Connect

API Connect proporciona dos entornos para tus integraciones:

Aspecto	Sandbox	Producción
Propósito	Desarrollo, testing, pruebas	Aplicaciones en vivo
Datos	Datos de prueba (NO datos reales)	Datos reales de tus clientes
SLA	Sin garantía de disponibilidad	99.9% uptime
Auditoría	No auditado	Auditoría completa
Reseteo	Puede ser reiniciado sin aviso	Nunca se reinicia
URL Auth	https://auth.connect.sandbox.quralo.com	https://auth.connect.quralo.com
URL API	https://connect.sandbox.quralo.com	https://connect.quralo.com
Audience	https://connect.sandbox.quralo.com	https://connect.quralo.com

Credenciales por Entorno

Cada entorno tiene credenciales diferentes:

Client ID y Client Secret

• Sandbox: client_id_sandbox y client_secret_sandbox (valores diferentes para dev)
• Producción: client_id_prod y client_secret_prod (valores diferentes y secretos)

⚠️ Importante: Nunca uses credenciales de Producción en Sandbox. Mantén los secrets seguros y no los versiones en git.

Organization ID

El org_id es un UUID único que identificador tu institución médica. Lo recibes cuando Quralo da de alta tu cuenta negocio.

org_id = "08bb856a-6cd6-45cc-9413-1ede5afeb2c4"  // Ejemplo

El mismo org_id se usa en ambos entornos, pero los client_id y client_secret son diferentes.

Cuándo usar cada entorno

Usa Sandbox cuando:

• ✅ Estés desarrollando tu integración
• ✅ Hagas pruebas antes de lanzar a producción
• ✅ Experimentes con nuevos endpoints o versiones de API
• ✅ Necesites resetear datos de prueba

Usa Producción cuando:

• ✅ Tu aplicación está lista para usuarios reales
• ✅ Necesites acceder a datos reales de pacientes y reportes
• ✅ Tu integración ya está en vivo

Cómo obtener credenciales

Actualmente

Quralo te proporciona las credenciales directamente cuando das de alta tu cuenta de negocios. Se entregarán de forma segura junto con:

• client_id (Sandbox y Producción)
• client_secret (Sandbox y Producción)
• org_id (mismo para ambos entornos)

Futuro: Quralo One

Próximamente, podrás acceder a tus credenciales desde el panel administrativo en https://one.quralo.com, donde podrás:

• Generar nuevas credenciales
• Rotar secrets de forma segura
• Administrar acceso por entorno

Migración de Sandbox a Producción

Cuando estés listo para pasar a Producción:

1. Prueba exhaustiva en Sandbox - Valida todos los flows
2. Cambia credenciales - Reemplaza client_id y client_secret de Sandbox por los de Producción
3. Actualiza URLs - Cambia la URL base de API de sandbox a connect.quralo.com
4. Testing final - Prueba con datos reales en Producción (si es posible de forma limitada)
5. Monitoreo - Supervisa logs y errores en Producción

Soporte

¿Necesitas credenciales nuevas o tienes dudas? Contáctanos en soporte@quralo.com