Ir para o conteúdo

API de Estimativa de VO2max

Crie perfis de aptidão cardiorrespiratória a partir do desempenho em testes de campo e fisiologia em repouso.

Endpoint

  • GET /api/v1/fitness/vo2max-estimate
  • POST /api/v1/fitness/vo2max-estimate/post

Parâmetros

Nome Tipo Obrigatório In Descrição
age inteiro (13-85) Sim Consulta/Corpo Idade em anos.
gender string Sim Consulta/Corpo male ou female.
resting_hr número (30-130) Sim Consulta/Corpo Frequência cardíaca em repouso em bpm.
cooper_test_distance número (800-5000) Condicional Consulta/Corpo Distância do teste de 12 minutos do Cooper em metros.
1_5_mile_time número (6-30) Condicional Consulta/Corpo Tempo de corrida de 1,5 milhas em minutos.
lang string Não Consulta Idioma da resposta (en,es,de,fr,pt,ja,hi,ar).

Por que Usar Este Endpoint

  • Combine vários métodos de estimativa de VO2 em uma única resposta.
  • Adicione orientação de classificação, percentil e foco de treinamento.
  • Suporte a recursos de idade de aptidão e análise de risco.

Comece

Exemplo de Requisição

curl -X GET "https://api.hefitapi.com/api/v1/fitness/vo2max-estimate?age=33&gender=male&resting_hr=56&cooper_test_distance=2800&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/vo2max-estimate/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"age":29,"gender":"female","resting_hr":60,"1_5_mile_time":11.8}'

Exemplo de Resposta

Info

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

{
  "age": 33,
  "gender": "male",
  "resting_hr_bpm": 56.0,
  "test_inputs": {"cooper_test_distance_m": 2800.0, "run_1_5_mile_time_min": null},
  "estimate_method": "cooper_blend",
  "estimate_method_label": "Cooper Blend",
  "vo2max_estimate_ml_kg_min": 51.2,
  "vo2max_range_ml_kg_min": {"lower": 45.1, "upper": 57.3},
  "fitness_classification": "excellent",
  "fitness_classification_label": "Excellent",
  "percentile_estimate": 87,
  "confidence": {"score": 84, "level": "medium", "level_label": "Medium", "notes": "Single-test blend provides solid directional estimate."},
  "cardiorespiratory_risk_insight": "Favorable cardiorespiratory profile.",
  "training_focus_recommendations": ["Maintain aerobic base and threshold progressions"],
  "derived_metrics": {"estimated_hr_max_bpm": 185, "hr_reserve_bpm": 129, "fitness_age_estimate_years": 28},
  "summary": "Excellent aerobic profile with strong performance potential.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "31a83dfecbe5a34b", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_vo2max_estimate", "response_language": "en"}
}

Posicionamento do Produto

Um endpoint de alto valor para aplicativos de resistência, pontuação de bem-estar e plataformas de diagnóstico de treinamento.

Nota

Forneça pelo menos uma entrada de teste de campo: cooper_test_distance ou 1_5_mile_time.

Endpoints Recomendados