API de Análise de Carga de Treino¶
Converta métricas de volume de treino em classificação de hipertrofia e orientação de programação com foco no risco.
Endpoint¶
GET /api/v1/fitness/volume-load-analysisPOST /api/v1/fitness/volume-load-analysis/post
Parâmetros¶
| Nome | Tipo | Obrigatório | In | Descrição |
|---|---|---|---|---|
total_sets | inteiro (1-60) | Sim | Consulta/Corpo | Número de séries por semana. |
avg_reps | número (1-40) | Sim | Consulta/Corpo | Número médio de repetições por série. |
avg_load | número (1-500) | Sim | Consulta/Corpo | Carga média por repetição (contexto equivalente em kg). |
muscle_group | string | Sim | Consulta/Corpo | chest, back, legs, shoulders, arms, glutes, core, full_body. |
lang | string | Não | Consulta | Idioma da resposta (en, es, de, fr, pt, ja, hi, ar). |
Por que Usar Este Endpoint¶
- Classifique a dose de treino em relação às zonas de hipertrofia.
- Detecte padrões de sobrecarga antes da falha de recuperação.
- Forneça painéis para treinadores com sinais de volume interpretáveis.
Exemplo de Requisição¶
curl -X GET "https://api.hefitapi.com/api/v1/fitness/volume-load-analysis?total_sets=18&avg_reps=10&avg_load=75&muscle_group=legs&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/fitness/volume-load-analysis/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"total_sets":26,"avg_reps":12,"avg_load":68,"muscle_group":"back"}'
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 requisição para este endpoint.
{
"muscle_group": "legs",
"muscle_group_label": "Legs",
"total_sets": 18,
"avg_reps": 10.0,
"avg_load": 75.0,
"weekly_volume_load": {"tonnage": 13500, "per_set_density": 750.0},
"hypertrophy_zone_classification": {"zone": "hypertrophy_optimal", "zone_label": "Hypertrophy Optimal", "insight": "Current load is well-positioned for growth adaptation."},
"overuse_warning": {"level": "low", "level_label": "Low"},
"hypertrophy_efficiency_score": 100,
"load_distribution_note": "Balanced volume and intensity profile.",
"recommendations": ["Maintain progression while protecting recovery"],
"next_review_window_days": 21,
"confidence_score": 80,
"summary": "Optimal hypertrophy dose with manageable fatigue profile.",
"language": "en",
"_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "ef35d53f9622ec8a", "quota": 120, "usage_tracking": true},
"_api_metadata_": {"endpoint_name": "fitness_volume_load_analysis", "response_language": "en"}
}
Posicionamento do Produto¶
Projetado para produtos de análise de força, ferramentas para treinadores e painéis de desempenho.
Nota
muscle_group deve corresponder ao conjunto de enumeração suportado.
Endpoints Recomendados¶
GET /api/v1/fitness/adaptive-training-load- API de Carga de Treino AdaptativaGET /api/v1/fitness/cortisol-stress-load- API de Carga de Estresse CortisonaGET /api/v1/fitness/weekly-checkin-analysis- API de Análise de Check-in SemanalGET /api/v1/bmi- API de BMIGET /api/v1/tdee- API de TDEEGET /api/v1/bmr- API de BMR