Saltar a contenido

API de Puntuación de Recuperación

Genera una puntuación diaria de preparación para la recuperación y un plan de acción a partir de los biomarcadores clave de recuperación.

Endpoint

  • GET /api/v1/fitness/recovery-score
  • POST /api/v1/fitness/recovery-score/post

Parámetros

Nombre Tipo Obligatorio Valor Descripción
sleep_hours número (0-16) Sí Consulta/Cuerpo Duración del sueño en horas.
resting_hr número (30-120) Sí Consulta/Cuerpo Frecuencia cardíaca en reposo en bpm.
hrv número (10-200) Sí Consulta/Cuerpo HRV en milisegundos.
muscle_soreness número (0-10) Sí Consulta/Cuerpo Puntuación de dolor percibido.
lang cadena No Consulta Idioma de respuesta (en,es,de,fr,pt,ja,hi,ar).

¿Por qué usar este Endpoint?

  • Crea recomendaciones de entrenamiento basadas en la preparación de forma diaria.
  • Detecta las señales de alerta de recuperación antes de la caída del rendimiento.
  • Proporciona flujos de trabajo de auto-regulación con decisiones estructuradas.

Comenzar

Ejemplo de Solicitud

curl -X GET "https://api.hefitapi.com/api/v1/fitness/recovery-score?sleep_hours=7.1&resting_hr=59&hrv=66&muscle_soreness=4.2&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/recovery-score/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"sleep_hours":6.3,"resting_hr":68,"hrv":44,"muscle_soreness":6.8}'

Ejemplo de Respuesta

Info

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

{
  "readiness_score": 73,
  "readiness_band": "ready",
  "readiness_label": "Ready",
  "recovery_summary": "Training can proceed with moderate quality focus.",
  "input_signals": {"sleep_hours": 7.1, "resting_hr_bpm": 59.0, "hrv_ms": 66.0, "muscle_soreness": 4.2},
  "component_scores": {"sleep_score": 85, "resting_hr_score": 69, "hrv_score": 58, "soreness_score": 58},
  "recovery_recommendations": ["Proceed with quality session while monitoring fatigue"],
  "decision_protocol": {"today": "train", "intensity": "moderate_high"},
  "today_priority_actions": ["Warm up thoroughly", "Hydration and post-session recovery"],
  "tomorrow_readiness_focus": ["Sleep consistency", "Low-stress recovery work"],
  "red_flag_escalations": [],
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "7f2552f2fb7ad884", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_recovery_score", "response_language": "en"}
}

Posicionamiento del Producto

Ideal para paneles de recuperación, motores de auto-regulación de entrenamiento y plataformas de coaching.

Nota

muscle_soreness es obligatorio y debe estar en el rango 0-10.

Endpoints Recomendados