Ir para o conteúdo

API de Metas de Progresso

Gere um cronograma de progresso em fases para metas de perda de peso, ganho, manutenção, resistência ou recomposição.

Endpoint

  • GET /api/v1/fitness/progression-targets
  • POST /api/v1/fitness/progression-targets/post

Parâmetros

Nome Tipo Obrigatório In Descrição
goal string Sim Consulta/Corpo fat_loss, muscle_gain, maintenance, endurance, recomposition.
current_weight número (35-300) Sim Consulta/Corpo Peso corporal atual em kg.
time_horizon_weeks inteiro (2-52) Sim Consulta/Corpo Tempo de duração alvo em semanas.
lang string Não Consulta Idioma da resposta (en, es, de, fr, pt, ja, hi, ar).

Por que Usar Este Endpoint

  • Crie metas semanais realistas com base em uma lógica de progresso segura.
  • Retorne limites de segurança mínimo/máximo para controle de risco.
  • Potencie fluxos de trabalho de check-in com regras claras de correção.

Começar

Exemplo de Solicitação

curl -X GET "https://api.hefitapi.com/api/v1/fitness/progression-targets?goal=recomposition&current_weight=82&time_horizon_weeks=12&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/progression-targets/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"goal":"fat_loss","current_weight":91,"time_horizon_weeks":16}'

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 solicitação para este endpoint.

{
  "goal": "recomposition",
  "goal_label": "Recomposition",
  "current_weight_kg": 82.0,
  "time_horizon_weeks": 12,
  "weekly_target_change_kg": -0.12,
  "safe_progression_bounds": {
    "weekly_change_kg_min": -0.33,
    "weekly_change_kg_max": 0.08,
    "total_change_kg_min": -3.94,
    "total_change_kg_max": 0.98
  },
  "weekly_targets": [
    {"week": 1, "target_weight_kg": 81.88, "change_from_start_kg": -0.12},
    {"week": 2, "target_weight_kg": 81.75, "change_from_start_kg": -0.25}
  ],
  "weekly_execution_targets": ["Hold protein and progressive training consistency"],
  "course_correction_triggers": ["Adjust intake if trend diverges for 2 consecutive weeks"],
  "compliance_scorecard": ["Track adherence to training, sleep, and nutrition"],
  "review_schedule": {"weekly": "trend review", "monthly": "strategy adjustment"},
  "summary": "Gradual progression target supports sustainable recomposition.",
  "adjustment_logic": "Use small weekly adjustments while preserving performance.",
  "safety_note": "Avoid aggressive shifts outside safe progression bounds.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "5df3ca7f3f4bad5e", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_progression_targets", "response_language": "en"}
}

Posicionamento do Produto

Projetado para suites de treinamento, aplicativos de transformação corporal e painéis de análise de progresso.

Nota

time_horizon_weeks deve estar entre 2 e 52.

Endpoints Recomendados