Saltar a contenido

API de Riesgo de Lesiones

Evalúa el riesgo de estar preparado para el entrenamiento y obtén acciones preventivas antes de que la sobrecarga se convierta en un problema de rendimiento o disponibilidad.

Endpoint

  • GET /api/v1/fitness/injury-risk
  • POST /api/v1/fitness/injury-risk/post

Parámetros

Nombre Tipo Requerido In Descripción
training_days entero (0-7) Sí Consulta/Cuerpo Número de días de entrenamiento por semana.
sleep_hours número (0-16) Sí Consulta/Cuerpo Duración promedio del sueño.
muscle_soreness número (0-10) Sí Consulta/Cuerpo Puntuación de dolor.
previous_injury tipo booleano Sí Consulta/Cuerpo true/false, 1/0, yes/no.
lang cadena No Consulta Idioma de la respuesta (en,es,de,fr,pt,ja,hi,ar).

¿Por qué usar este endpoint?

  • Detecta el aumento del riesgo de lesiones al principio de los ciclos de entrenamiento.
  • Traduce las señales de recuperación en intervenciones preventivas.
  • Automatiza las señales de alerta para los equipos de entrenamiento y cuidado.

Empezar

Ejemplo de solicitud

curl -X GET "https://api.hefitapi.com/api/v1/fitness/injury-risk?training_days=6&sleep_hours=6.1&muscle_soreness=7.2&previous_injury=true&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/injury-risk/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"training_days":5,"sleep_hours":7.0,"muscle_soreness":4.8,"previous_injury":false}'

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

{
  "risk_score": 69,
  "risk_level": "moderate",
  "risk_label": "Moderate",
  "preventive_focus": "Prioritize mobility and controlled volume progression.",
  "mobility_advice": [
    "Add 10-15 minutes of daily mobility prep.",
    "Reduce sudden intensity jumps."
  ],
  "daily_readiness_protocol": {
    "sleep_gate": "minimum 7h",
    "soreness_check": "keep below 6/10 for heavy sessions"
  },
  "return_to_load_plan": ["Use progressive overload in small weekly steps"],
  "session_modifiers": ["Swap one hard day for low-impact conditioning"],
  "escalation_flags": ["High training frequency"],
  "component_load": {
    "training_load_pressure": 30.0,
    "sleep_pressure": 15.8,
    "soreness_pressure": 21.6,
    "injury_history_pressure": 0.0
  },
  "inputs": {
    "training_days": 6,
    "sleep_hours": 6.1,
    "muscle_soreness": 7.2,
    "previous_injury": false
  },
  "summary": "Moderate risk profile; adjust volume and recovery cadence.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "cb8af45a1c56e3c8",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "fitness_injury_risk",
    "response_language": "en"
  }
}

Posicionamiento del producto

Ideal para aplicaciones de entrenamiento de equipos, sistemas de coaching cercanos a la rehabilitación y monitorización de la preparación de las empresas.

Nota

previous_injury acepta valores similares a booleanos (true/false, 1/0, yes/no).

Endpoints recomendados