Ir para o conteúdo

Cronograma de Recuperação Muscular API

Calcule quando treinar um grupo muscular novamente com base em entradas de carga de trabalho, experiência de treinamento, proteína e recuperação do sono.

Endpoint

  • GET /api/v1/fitness/muscle-recovery-timeline
  • POST /api/v1/fitness/muscle-recovery-timeline/post

Parâmetros

Nome Tipo Obrigatório In Descrição
muscle_group string Sim Consulta/Corpo chest,back,legs,shoulders,arms,core,glutes,calves,full_body.
workout_intensity string Sim Consulta/Corpo low,moderate,high,very_high,maximal.
total_sets inteiro (1-60) Sim Consulta/Corpo Número de séries trabalhadas para a sessão.
training_age_years número (0-40) Sim Consulta/Corpo Experiência de treinamento em anos.
protein_intake número (30-450) Sim Consulta/Corpo Consumo diário de proteína em gramas.
sleep_hours número (0-16) Sim Consulta/Corpo Duração do sono.
lang string Não Consulta Idioma da resposta (en,es,de,fr,pt,ja,hi,ar).

Por que Usar Este Endpoint

  • Elimine a incerteza em torno do tempo de recondicionamento.
  • Quantifique o risco de supertreinamento devido ao recondicionamento precoce.
  • Forneça recomendações imediatas de recuperação ativa.

Começar

Exemplo de Solicitação

curl -X GET "https://api.hefitapi.com/api/v1/fitness/muscle-recovery-timeline?muscle_group=legs&workout_intensity=high&total_sets=18&training_age_years=4&protein_intake=160&sleep_hours=6.8&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/muscle-recovery-timeline/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"muscle_group":"chest","workout_intensity":"very_high","total_sets":16,"training_age_years":2,"protein_intake":130,"sleep_hours":7.2}'

Exemplo de Resposta

Info

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

{
  "muscle_group": "legs",
  "muscle_group_label": "Legs",
  "workout_intensity": "high",
  "workout_intensity_label": "High",
  "total_sets": 18,
  "training_age_years": 4.0,
  "protein_intake_g": 160.0,
  "sleep_hours": 6.8,
  "estimated_recovery_time_hours": 90,
  "optimal_retraining_window_hours": {"start": 84, "end": 108, "insight": "Allow full tissue recovery before repeat loading."},
  "overtraining_risk_if_trained_earlier": {"risk_score": 79, "risk_level": "very_high", "risk_label": "Very High", "insight": "Early retraining likely to reduce output and recovery."},
  "suggested_active_recovery_strategy": ["Low-intensity movement and mobility work"],
  "fatigue_carryover_warning": {"level": "severe", "level_label": "Severe", "warning": "High carryover fatigue risk from current session load."},
  "confidence_score": 73,
  "confidence_label": "Moderate",
  "recovery_driver_breakdown": {
    "base_hours": 72.0,
    "intensity_adjustment": 8.0,
    "set_volume_adjustment": 10.8,
    "training_age_adjustment": 0.0,
    "protein_adjustment": -2.0,
    "sleep_adjustment": 6.0
  },
  "summary": "Extended recovery window recommended before heavy retraining.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "0a26e0765f73ff84", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_muscle_recovery_timeline", "response_language": "en"}
}

Posicionamento do Produto

Projetado para treinamento de elite, automação de recuperação e programas de alta frequência.

Nota

total_sets suporta 1-60; valores fora dessa faixa retornam HTTP 400.

Endpoints Recomendados