Saltar a contenido

API del Optimizador de Sueño

Genera diagnósticos de calidad del sueño y un protocolo práctico de optimización para mejorar la recuperación nocturna.

Endpoint

  • GET /api/v1/fitness/sleep-optimizer
  • POST /api/v1/fitness/sleep-optimizer/post

Parámetros

Nombre Tipo Requerido En Descripción
sleep_hours número (0-16) Sí Consulta/Cuerpo Duración total del sueño.
sleep_consistency_score entero (0-100) Sí Consulta/Cuerpo Consistencia del horario de sueño.
caffeine_intake_mg número (0-1200) Sí Consulta/Cuerpo Consumo diario de cafeína en mg.
screen_time_before_bed número (0-360) Sí Consulta/Cuerpo Tiempo de exposición a pantallas antes de dormir (en minutos).
lang cadena No Consulta Idioma de la respuesta (en,es,de,fr,pt,ja,hi,ar).

¿Por qué usar este Endpoint?

  • Cuantifica la calidad del sueño y circadiana en una única salida.
  • Obtén pasos de optimización dirigidos para una rápida iteración de comportamientos.
  • Mejora los resultados de recuperación y entrenamiento a través de intervenciones relacionadas con el sueño.

Comenzar

Ejemplo de Solicitud

curl -X GET "https://api.hefitapi.com/api/v1/fitness/sleep-optimizer?sleep_hours=6.9&sleep_consistency_score=62&caffeine_intake_mg=260&screen_time_before_bed=75&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/sleep-optimizer/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"sleep_hours":7.8,"sleep_consistency_score":84,"caffeine_intake_mg":120,"screen_time_before_bed":20}'

Ejemplo de Respuesta

Info

El ejemplo de respuesta a continuación es solo para demostración. Para recibir la estructura JSON completa, en tiempo real y potencialmente más rica, realiza una solicitud en vivo a este endpoint.

{
  "sleep_hours": 6.9,
  "sleep_consistency_score": 62,
  "caffeine_intake_mg": 260.0,
  "screen_time_before_bed_minutes": 75.0,
  "sleep_quality_score": 55,
  "sleep_quality_band": {"band": "fragile", "band_label": "Fragile"},
  "circadian_alignment_insight": {"score": 58, "status": "misaligned", "status_label": "Misaligned", "insight": "Current schedule and habits reduce circadian stability."},
  "optimization_protocol": ["Reduce late caffeine and screen exposure", "Anchor wake time consistency"],
  "recovery_priority": "Stabilize routine before increasing training stress.",
  "next_adjustment_window_days": 3,
  "confidence_score": 77,
  "summary": "Sleep profile is fragile; near-term routine correction advised.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "56e5dbbb8de53ceb", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_sleep_optimizer", "response_language": "en"}
}

Posicionamiento del Producto

Característica premium para aplicaciones de recuperación, coaching de rendimiento y plataformas de comportamiento de bienestar.

Nota

screen_time_before_bed se mide en minutos.

Endpoints Recomendados