Ir para o conteúdo

Previsão de Recomposição do Corpo

Estime a trajetória esperada de perda de gordura vs. ganho de massa muscular e a probabilidade de uma recomposição bem-sucedida, incluindo blocos de projeção de 4/8/12 semanas.

Endpoint

  • GET /api/v1/fitness/body-recomp-forecast
  • POST /api/v1/fitness/body-recomp-forecast/post

Parâmetros

Nome Tipo Obrigatório In Descrição
current_weight número (35-300) Sim Consulta/Corpo Peso corporal atual em kg.
body_fat_percentage número (5-60) Sim Consulta/Corpo Percentual de gordura corporal.
calorie_intake número (800-6000) Sim Consulta/Corpo Consumo diário médio.
protein_intake número (40-450) Sim Consulta/Corpo Proteína diária em gramas.
training_days inteiro (0-7) Sim Consulta/Corpo Número de dias de treino de resistência por semana.
experience_level string Sim Consulta/Corpo beginner,intermediate,advanced,elite.
lang string Não Consulta Idioma da resposta (en,es,de,fr,pt,ja,hi,ar).

Por que Usar Este Endpoint

  • Transforme dados estáticos de ingestão/treino em resultados de recomposição projetados.
  • Priorize os usuários com base na probabilidade de recomposição para intervenções de coaching.
  • Ofereça visibilidade do tempo para melhorar a adesão e a retenção.

Começar

Exemplo de Requisição

curl -X GET "https://api.hefitapi.com/api/v1/fitness/body-recomp-forecast?current_weight=84&body_fat_percentage=24&calorie_intake=2350&protein_intake=165&training_days=4&experience_level=intermediate&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/body-recomp-forecast/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "current_weight": 84,
    "body_fat_percentage": 24,
    "calorie_intake": 2350,
    "protein_intake": 165,
    "training_days": 4,
    "experience_level": "intermediate"
  }'

Exemplo de Resposta

Info

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

{
  "current_weight_kg": 84.0,
  "body_fat_percentage": 24.0,
  "calorie_intake": 2350,
  "protein_intake_g": 165.0,
  "training_days": 4,
  "experience_level": "intermediate",
  "experience_level_label": "Intermediate",
  "estimated_fat_loss_vs_muscle_gain_ratio": {
    "fat_loss_kg_per_week": 0.23,
    "muscle_gain_kg_per_week": 0.13,
    "fat_to_muscle_ratio": 1.77,
    "ratio_label": "balanced_recomp",
    "ratio_label_text": "Balanced recomp"
  },
  "recomp_probability_score": {
    "score": 73,
    "band": "moderate",
    "band_label": "Moderate",
    "insight": "Good potential with consistency."
  },
  "timeline_projection": [
    {
      "week": 4,
      "projected_weight_kg": 83.6,
      "projected_body_fat_percent": 23.2,
      "estimated_fat_mass_change_kg": -0.92,
      "estimated_lean_mass_change_kg": 0.52
    }
  ],
  "strategy_adjustment_advice": ["Keep protein high", "Maintain progressive overload"],
  "metabolic_context": {
    "estimated_maintenance_calories": 2720,
    "daily_energy_gap": -370,
    "protein_g_per_kg": 1.96
  },
  "confidence_score": 84,
  "summary": "Consistent execution can deliver measurable recomposition.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "4b2ad1f68d3dc50a",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "Health Fitness API by Dakidarts®",
    "endpoint_name": "fitness_body_recomp_forecast",
    "response_language": "en"
  }
}

Posicionamento no Mercado

Excelente para plataformas de coaching de alto engajamento e produtos de fitness premium onde os usuários precisam de previsões de progresso baseadas em probabilidade.

Nota

A validação é rigorosa para todas as entradas com intervalos definidos (peso, gordura corporal, calorias, proteína e dias de treino).

Endpoints Recomendados