Quro API

API Explorer v2 - Arquitectura Modular

Interfaz avanzada para probar y monitorear los endpoints v2 con cache, retry automático y métricas en tiempo real

Versión 2.0

4 Endpoints
Base: /api/v2
Performance
N/A
Tiempo promedio
Cache
0
Entradas en cache
Requests
0
Total procesados
Estado
Sistema saludable
Ubicaciones de Vehículos v2
POST
/vehicle-locations

Obtiene ubicaciones de vehículos con arquitectura modular mejorada

Características v2:
Cache automático (5 min)
Retry automático (3 intentos)
Validaciones estrictas
Headers de paginación
Logging estructurado
v2 locations performance cache
2 ejemplos disponibles
Sin auth
Últimas Ubicaciones v2
POST
/vehicle-locations/latest

Obtiene la última ubicación conocida de cada vehículo (optimizado)

Características v2:
Optimizado para dashboards
Menor latencia
Procesamiento en lotes
Cache inteligente
v2 latest realtime dashboard
2 ejemplos disponibles
Sin auth
Health Check v2
GET
/vehicle-locations/health

Verifica el estado de salud del servicio v2

Características v2:
Estado de dependencias
Verificación de cache
Conectividad MongoDB
Métricas de sistema
v2 health monitoring status
1 ejemplo disponible
Sin auth
Métricas de Performance v2
GET
/vehicle-locations/metrics

Obtiene estadísticas de rendimiento y uso del servicio

Características v2:
Tiempo de respuesta promedio
Tasa de hit del cache
Conteo de requests
Tasa de errores
Estadísticas de conexión
v2 metrics performance analytics
1 ejemplo disponible
Requiere auth
Ubicaciones de Vehículos v2
POST
/vehicle-locations

Obtiene ubicaciones de vehículos con arquitectura modular mejorada

Características v2:
Cache automático (5 min)
Retry automático (3 intentos)
Validaciones estrictas
Headers de paginación
Logging estructurado
v2 locations performance cache
2 ejemplos disponibles
Sin auth
Últimas Ubicaciones v2
POST
/vehicle-locations/latest

Obtiene la última ubicación conocida de cada vehículo (optimizado)

Características v2:
Optimizado para dashboards
Menor latencia
Procesamiento en lotes
Cache inteligente
v2 latest realtime dashboard
2 ejemplos disponibles
Sin auth
Health Check v2
GET
/vehicle-locations/health

Verifica el estado de salud del servicio v2

Características v2:
Estado de dependencias
Verificación de cache
Conectividad MongoDB
Métricas de sistema
v2 health monitoring status
1 ejemplo disponible
Sin auth
Métricas de Performance v2
GET
/vehicle-locations/metrics

Obtiene estadísticas de rendimiento y uso del servicio

Características v2:
Tiempo de respuesta promedio
Tasa de hit del cache
Conteo de requests
Tasa de errores
Estadísticas de conexión
v2 metrics performance analytics
1 ejemplo disponible
Requiere auth

Comparación v1 vs v2

Comparación detallada de características y mejoras

Característica v1 (Original) v2 (Modular) Mejora
Arquitectura Monolítica Modular Mejor mantenibilidad
Cache No disponible 5 min TTL automático 60% menos queries MySQL
Retry Logic Manual 3 intentos automáticos Mayor confiabilidad
Validación Básica Estricta con transformación Menos errores
Logging Problemático (nulls) Estructurado sin nulls Mejor debugging
Monitoreo No disponible Health checks + métricas Observabilidad completa
Rendimiento Estimado
v1: ~2.5s
v2: ~1.2s
v1: Consultas múltiples
v2: Cache + optimización
⚡ Mejora del 50% en rendimiento
Confiabilidad
v1
  • ❌ Sin retry automático
  • ❌ Logs con nulls
  • ❌ Sin cache
  • ❌ Error handling básico
v2
  • ✅ 3 reintentos automáticos
  • ✅ Logging estructurado
  • ✅ Cache de 5 minutos
  • ✅ Error handling robusto
🛡️ 95% de uptime garantizado
Guía de Migración Recomendada
Pasos para migrar:
  1. Probar endpoints v2 en paralelo
  2. Validar compatibilidad de responses
  3. Actualizar frontend gradualmente
  4. Monitorear métricas de rendimiento
  5. Deprecar v1 después de verificación
Beneficios inmediatos:
  • Reducción de latencia 50%
  • Menos queries a BD 60%
  • Logs más limpios 100%
  • Confiabilidad 95%