API BMR¶
Calcule o BMR e gere resultados úteis para planejamento de perda de gordura, manutenção e ganho de massa muscular.
Endpoint¶
GET /api/v1/bmrPOST /api/v1/bmr/post
Parâmetros¶
| Nome | Tipo | Obrigatório | In | Descrição |
|---|---|---|---|---|
age | inteiro | Sim | Query/Corpo | Idade em anos. |
weight | número | Sim | Query/Corpo | Peso em quilogramas. |
height | número | Sim | Query/Corpo | Altura em centímetros. |
gender | string (male,female) | Sim | Query/Corpo | Sexo biológico. |
equation | string (mifflin,harris) | Não | Query | Seletor de fórmula (usa mifflin por padrão). |
lang | string | Não | Query | Idioma da resposta (en,es,de,fr,pt,ja,hi,ar). |
Por que Usar Este Endpoint¶
- Suporte ao planejamento de calorias em fluxos de onboarding e coaching.
- Comparar o comportamento da equação com controle de fórmula explícita.
- Adicionar faixas metabólicas interpretáveis para motores de personalização.
Exemplo de Requisição¶
curl -X GET "https://api.hefitapi.com/api/v1/bmr?age=34&weight=78&height=175&gender=male&equation=mifflin&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/bmr/post?equation=mifflin&lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"age": 34, "weight": 78, "height": 175, "gender": "male"}'
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.
{
"bmr": "1708.75 kcal/day",
"bmr_kcal_per_day": 1708.75,
"profile": {
"age": 34,
"weight_kg": 78.0,
"height_cm": 175.0,
"gender": "male",
"equation": "mifflin"
},
"metabolic_band": "moderate",
"metabolic_band_label": "Moderate",
"target_calorie_ranges": {
"fat_loss": 1743,
"maintenance_proxy": 2221,
"muscle_gain": 2392
},
"risk_signal": "Energy needs are moderate and manageable.",
"action_plan": ["Align intake with goal phase", "Track weekly response"],
"monitoring_plan": "Recalculate when weight changes materially.",
"language": "en",
"_enterprise": {
"client": "Acme Health",
"plan": "pro",
"request_id": "b76dbf5f8f5729c1",
"quota": 120,
"usage_tracking": true
},
"_api_metadata_": {
"api_name": "Health Fitness API by Dakidarts®",
"endpoint_name": "bmr",
"response_language": "en"
}
}
Posicionamento do Produto¶
Um endpoint principal para SaaS de nutrição, aplicativos de coaching e sistemas de inteligência de saúde corporativa que precisam de modelagem de energia básica.
Nota
equation é passado como parâmetro de consulta em ambas as variantes dos endpoints GET e POST.
Endpoints Recomendados¶
GET /api/v1/bmi- API BMIGET /api/v1/tdee- API TDEEGET /api/v1/protein-calculator- Calculadora de ProteínaGET /api/v1/fitness/heart-rate-zones- API de Zonas de Frequência CardíacaGET /api/v1/bodyfat- API de Gordura CorporalGET /api/v1/maintenance-calorie- API de Calorias para Manutenção