Saltar a contenido

🔍 Smoke Tests PIT — Verificación del Sistema

Esta herramienta te permite verificar el estado completo del sistema PIT API de forma visual y en tiempo real.

🚀 Acceso a la Herramienta

Abrir Smoke Tests →

📋 Qué verifica

1. Dataset publicado

  • ✅ Accesibilidad de /data/calendario260.json
  • ✅ Content-Type correcto (application/json)
  • ✅ Disponibilidad del archivo

2. Endpoints /details

  • ✅ Kins DS: 178, 19, 177, 55
  • ✅ Kins GMT: 134, 235, 160, 1, 137
  • ✅ Payload correcto con kin y corr
  • ✅ Status HTTP 200

3. CORS preflight

  • ✅ OPTIONS request funciona
  • ✅ Headers CORS presentes
  • ✅ Status 204/200
  • ✅ Access-Control-Allow-Origin
  • ✅ Access-Control-Allow-Methods
  • ✅ Access-Control-Allow-Headers

🎯 Tipos de pruebas

🚀 Smoke Tests Completos

  • Verifica todo el sistema
  • Incluye dataset, endpoints y CORS
  • Ideal para verificación completa

⚡ Test Rápido

  • Solo verifica un endpoint básico
  • Ideal para verificación rápida
  • Menos tiempo de ejecución

⚙️ Configuración

URL Base de la API

  • Por defecto: https://pit-api.pages.dev
  • Personalizable: Cambia la URL base si necesitas probar otros entornos

Origen CORS

  • Por defecto: https://losacroloprofano.github.io
  • Personalizable: Cambia el origen para probar CORS desde otros dominios

📊 Estadísticas en tiempo real

La herramienta muestra: - Tests Ejecutados: Total de verificaciones realizadas - Exitosos: Tests que pasaron correctamente - Fallidos: Tests que fallaron - Duración: Tiempo total de ejecución

🔧 Uso desde línea de comandos

También puedes ejecutar los smoke tests desde terminal:

# Smoke tests completos
npm run smoke

# Con URL base personalizada
PIT_API_BASE=https://pit-api.pages.dev npm run smoke

🛡️ Seguridad

  • Solo lectura: No modifica datos
  • Dominios autorizados: Respeta la configuración CORS
  • Rate limiting: Evita spam de requests
  • Sin secretos: No requiere autenticación

🚨 Troubleshooting

Error: "Dataset no accesible"

  • Verifica que el deploy esté completo
  • Confirma que data/calendario260.json existe
  • Revisa la URL base de la API

Error: "Endpoint no responde"

  • Verifica que la función esté desplegada
  • Confirma que el endpoint esté activo
  • Revisa los logs de Cloudflare Pages

Error: "CORS fallido"

  • Verifica la configuración CORS
  • Confirma que el origen esté autorizado
  • Revisa los headers de respuesta

📈 Monitoreo continuo

  • CI/CD: Los smoke tests se ejecutan automáticamente en cada push
  • Schedule: Verificación diaria a las 06:20 (America/Bogota)
  • Manual: Ejecuta cuando necesites verificar el estado

🔄 Integración con CI

Los smoke tests están integrados en GitHub Actions:

name: API Validate (details)
on:
  push:
    branches: [ main ]
  schedule:
    - cron: "20 11 * * *" # 06:20 America/Bogota

📚 Referencias