Ir para o conteúdo

API de IMC

Calcule o Índice de Massa Corporal a partir de entradas métricas (height em centímetros, weight em quilogramas), com opções de formatação de saída via units.

Endpoint

  • GET /api/v1/bmi
  • POST /api/v1/bmi/post

Parâmetros

Nome Tipo Obrigatório In Descrição
height número Sim Consulta/Corpo Altura em centímetros.
weight número Sim Consulta/Corpo Peso em quilogramas.
units string (metric,imperial) Não Consulta/Corpo Preferência de formatação de saída. Por padrão, usa metric.
lang string Não Consulta Idioma da resposta (en,es,de,fr,pt,ja,hi,ar).

Por que Usar Este Endpoint

  • Adicione a pontuação de IMC padrão para onboarding e check-ins periódicos.
  • Inicie fluxos de trabalho de coaching de estilo de vida com base na classificação de risco.
  • Mantenha a ingestão de dados métricos, ao mesmo tempo em que oferece saída formatada em estilo imperial.

Começar

Exemplo de Requisição

curl -X GET "https://api.hefitapi.com/api/v1/bmi?height=178&weight=82&units=metric&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/bmi/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"height": 178, "weight": 82, "units": "metric"}'

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

{
  "height": "1.8 m",
  "weight": "82.0 kg",
  "bmi": "25.9 kg/m2",
  "weight_status": "Overweight",
  "bmi_value": 25.88,
  "weight_status_band": "overweight",
  "weight_status_label": "Overweight",
  "risk_signal": "Weight trend may increase long-term cardiometabolic risk.",
  "action_plan": ["Tighten calorie quality", "Increase weekly activity volume"],
  "monitoring_plan": "Reassess in 4-6 weeks.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "2d8f0fe12d5ab429",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "Health Fitness API by Dakidarts®",
    "endpoint_name": "bmi",
    "response_language": "en"
  }
}

Adequação do Produto

Ótimo para onboarding de bem-estar, painéis de risco e plataformas de saúde corporativa que precisam de uma métrica antropométrica básica rápida.

Nota

A entrada para este endpoint é métrica. Para cálculos de entrada em estilo imperial, use o endpoint bmi_imperial.

Endpoints Recomendados