Ir para o conteúdo

API de Carga de Treino Adaptativa

Retorne uma decisão de treino consciente do estado de prontidão (push, maintain, pull_back) com delta de intensidade, ajuste de volume, mudança de lesão e pontuação de confiança.

Endpoint

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

Parâmetros

Nome Tipo Obrigatório In Descrição
planned_intensity número (1-10) Sim Consulta/Corpo Intensidade planejada da sessão.
recovery_score número (0-100) Sim Consulta/Corpo Pontuação de recuperação agregada.
sleep_hours número (0-16) Sim Consulta/Corpo Duração do sono da noite anterior.
hrv número (10-200) Sim Consulta/Corpo Entrada HRV usada para pontuação de prontidão.
muscle_soreness número (0-10) Sim Consulta/Corpo Classificação subjetiva de desconforto.
goal string Sim Consulta/Corpo fat_loss, muscle_gain, performance, maintenance, recomposition.
lang string Não Consulta Idioma da resposta (en,es,de,fr,pt,ja,hi,ar).

Por que Usar Este Endpoint

  • Fornecer auto-regulação como um serviço para aplicativos de treinamento.
  • Reduzir o risco de sobretreinamento usando entradas objetivas e subjetivas de prontidão.
  • Fornecer ajustes de sessão explicáveis para atletas e treinadores.

Começar

Exemplo de Solicitação

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"
  }'

Exemplo de Resposta

Info

O exemplo de resposta abaixo é apenas para fins demonstrativos. Faça uma solicitação real para este endpoint para receber a estrutura JSON completa, em tempo real e potencialmente mais rica.

{
  "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"
  }
}

Adequação de Mercado

Ideal para coaching premium, monitoramento de atletas e produtos de programação adaptativa onde as decisões de treinamento diárias impulsionam a retenção e os resultados.

Nota

A validação impõe restrições rigorosas para intensidade, pontuação de recuperação, HRV, sono e desconforto.

Endpoints Recomendados