Ir para o conteúdo

Executar a API de Economia

Quantifique a eficiência da corrida e retorne as ferramentas de treinamento que melhoram os resultados de velocidade por esforço.

Endpoint

  • GET /api/v1/fitness/running-economy
  • POST /api/v1/fitness/running-economy/post

Parâmetros

Nome Tipo Obrigatório In Descrição
pace_per_km número (2,0-15,0) Sim Consulta/Corpo Ritmo médio por quilômetro (minutos).
heart_rate_avg número (80-210) Sim Consulta/Corpo Frequência cardíaca média em bpm.
vo2max número (15-90) Sim Consulta/Corpo Estimativa/valor de VO2 max.
body_weight número (35-250) Sim Consulta/Corpo Peso corporal em kg.
lang string Não Consulta Idioma da resposta (en,es,de,fr,pt,ja,hi,ar).

Por que Usar Este Endpoint

  • Transformar dados de corrida em um único sinal de eficiência claro.
  • Comparar o desempenho por meio de percentis e faixas.
  • Retornar sugestões práticas para melhoria.

Começar

Exemplo de Requisição

curl -X GET "https://api.hefitapi.com/api/v1/fitness/running-economy?pace_per_km=4.9&heart_rate_avg=162&vo2max=51&body_weight=73&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/running-economy/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"pace_per_km":5.6,"heart_rate_avg":171,"vo2max":45,"body_weight":80}'

Exemplo de Resposta

Info

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

{
  "pace_per_km": 4.9,
  "heart_rate_avg_bpm": 162.0,
  "vo2max_ml_kg_min": 51.0,
  "body_weight_kg": 73.0,
  "running_efficiency_score": 79,
  "efficiency_band": {"band": "strong", "band_label": "Strong", "insight": "Strong economy profile with room for refinement."},
  "economy_percentile": 79,
  "economy_index": 33.2,
  "efficiency_components": {"pace_component": 41.4, "heart_rate_component": 15.4, "aerobic_component": 39.0, "mass_penalty": 2.9},
  "improvement_lever_suggestions": ["Use threshold intervals and aerobic volume consistency"],
  "stimulus_focus": "Threshold + aerobic durability",
  "confidence_score": 87,
  "summary": "Running economy is strong with targeted gains available.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "93027cd0f866757d", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_running_economy", "response_language": "en"}
}

Posicionamento do Produto

Um recurso diferenciado para análise de desempenho, aplicativos de treinamento e produtos de desempenho de corrida.

Nota

pace_per_km espera o formato de minutos por km, não a velocidade em km/h.

Endpoints Recomendados