Ir para o conteúdo

API Karvonen

Forneça orientação precisa para o BPM de alvo durante as sessões de cardio com controle de intensidade baseado na reserva.

Endpoint

  • GET /api/v1/karvonen
  • POST /api/v1/karvonen/post

Parâmetros

Nome Tipo Obrigatório In Descrição
age inteiro (>0) Sim Query/Corpo Idade em anos.
rhr inteiro (>0) Sim Query/Corpo Frequência cardíaca em repouso em bpm.
intensity número (10-100) Sim Query/Corpo Percentual de intensidade do treino alvo.
mhr inteiro (>0) Não Query/Corpo Máx. HR; se omitido, a API usa 220 - age.
lang string Não Query Idioma da resposta (en,es,de,fr,pt,ja,hi,ar).

Por que Usar Este Endpoint

  • Use metas de frequência cardíaca baseadas na reserva em vez de zonas genéricas.
  • Ajuste o design da sessão para zonas de recuperação, aeróbica, limiar e HIIT.
  • Adicione matemática de zona de alvo transparente para aplicativos de cardio de consumo.

Começar

Exemplo de Requisição

curl -X GET "https://api.hefitapi.com/api/v1/karvonen?age=35&rhr=58&intensity=72&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/karvonen/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"age":35,"rhr":58,"mhr":188,"intensity":78}'

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.

{
  "age": 35,
  "resting_heart_rate_bpm": 58,
  "maximum_heart_rate_bpm": 185,
  "used_default_max_hr": true,
  "heart_rate_reserve_bpm": 127,
  "intensity_percent": 72.0,
  "target_heart_rate_bpm": 149.44,
  "training_zone_range_bpm": {
    "min": 143.09,
    "max": 155.79
  },
  "intensity_band": "aerobic",
  "intensity_band_label": "Aerobic",
  "risk_signal": "Sustainable zone for base-building sessions.",
  "action_plan": ["Use longer steady-state intervals"],
  "monitoring_plan": "Track drift and perceived exertion each session.",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "dd67b47d2223915c",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "karvonen",
    "response_language": "en"
  }
}

Posicionamento do Produto

Excelente para aplicativos de resistência, painéis de treinamento e plataformas de academia que exigem automação de BPM alvo repetível.

Nota

Se mhr for omitido, a taxa máxima de batimentos cardíacos será definida como 220 - age.

Endpoints Recomendados