Saltar a contenido

API de Carga de Entrenamiento Adaptativa

Devuelve una decisión de entrenamiento consciente de la preparación (push, maintain, pull_back) con delta de intensidad, ajuste de volumen, cambio de lesión y puntuación de confianza.

Endpoint

  • GET /api/v1/fitness/adaptive-training-load
  • POST /api/v1/fitness/adaptive-training-load/post

Parámetros

Nombre Tipo Requerido En Descripción
planned_intensity número (1-10) Sí Consulta/Cuerpo Intensidad planificada de la sesión.
recovery_score número (0-100) Sí Consulta/Cuerpo Puntuación de recuperación agregada.
sleep_hours número (0-16) Sí Consulta/Cuerpo Duración del sueño de la noche anterior.
hrv número (10-200) Sí Consulta/Cuerpo Entrada de HRV utilizada para la puntuación de preparación.
muscle_soreness número (0-10) Sí Consulta/Cuerpo Puntuación subjetiva de dolor.
goal cadena Sí Consulta/Cuerpo fat_loss, muscle_gain, performance, maintenance, recomposition.
lang cadena No Consulta Idioma de la respuesta (en,es,de,fr,pt,ja,hi,ar).

¿Por qué usar este Endpoint

  • Proporciona la auto-regulación como un servicio para las aplicaciones de entrenamiento.
  • Reduce el riesgo de sobreentrenamiento utilizando entradas objetivas y subjetivas de preparación.
  • Proporciona ajustes de sesión explicables para atletas y entrenadores.

Comenzar

Ejemplo de Solicitud

curl -X GET "https://api.hefitapi.com/api/v1/fitness/adaptive-training-load?planned_intensity=7&recovery_score=74&sleep_hours=7.2&hrv=58&muscle_soreness=4&goal=performance&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/adaptive-training-load/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "planned_intensity": 7,
    "recovery_score": 74,
    "sleep_hours": 7.2,
    "hrv": 58,
    "muscle_soreness": 4,
    "goal": "performance"
  }'

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, realice una solicitud real a este endpoint.

{
  "planned_intensity": 7.0,
  "adjusted_training_intensity_recommendation": 7.9,
  "adjusted_training_intensity_delta": 0.9,
  "volume_adjustment_percent": 8,
  "decision": "push",
  "decision_label": "Push",
  "injury_probability_shift_percent_points": -1.8,
  "performance_optimization_note": "Readiness supports a progressive session.",
  "confidence_score": 87,
  "confidence_label": "High",
  "goal": "performance",
  "goal_label": "Performance",
  "readiness_signals": {
    "recovery_score": 74.0,
    "sleep_hours": 7.2,
    "hrv": 58.0,
    "muscle_soreness": 4.0,
    "composite_readiness_score": 75.8
  },
  "recommended_action_blocks": [
    "Increase load slightly on primary lift.",
    "Keep movement quality high across sets."
  ],
  "summary": "Train hard with quality control.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "35ce4816f312aa0b",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "Health Fitness API by Dakidarts®",
    "endpoint_name": "fitness_adaptive_training_load",
    "response_language": "en"
  }
}

Adecuación del Mercado

Ideal para coaching premium, monitorización de atletas y productos de programación adaptativa donde las decisiones de entrenamiento diarias impulsan la retención y los resultados.

Nota

La validación impone rangos estrictos para la intensidad, la puntuación de recuperación, el HRV, el sueño y el dolor.

Endpoints Recomendados