Ir para o conteúdo

API de Gordura Corporal (Entrada em Métricas)

Estime a porcentagem de gordura corporal a partir de entradas baseadas no modelo de IMC e retorne faixas de classificação específicas para o sexo.

Endpoint

  • GET /api/v1/bodyfat
  • POST /api/v1/bodyfat/post

Parâmetros

Nome Tipo Obrigatório In Descrição
gender string (male,female) Sim Consulta/Corpo Sexo biológico.
age número Sim Consulta/Corpo Idade em anos.
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 Formato de exibição de saída apenas. 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 estimativa de gordura corporal sem dispositivos de medição de pregas cutâneas.
  • Segmente usuários por faixa de adiposidade para automação de treinamento.
  • Combine com os endpoints de IMC/BMR para obter um contexto de composição completo.

Começar

Exemplo de Requisição

curl -X GET "https://api.hefitapi.com/api/v1/bodyfat?gender=female&age=33&height=165&weight=68&units=metric&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/bodyfat/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"gender":"female","age":33,"height":165,"weight":68,"units":"metric"}'

Exemplo de Resposta

Info

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

{
  "height": "1.6 m",
  "weight": "68.0 kg",
  "bmi": "25.0 kg/m2",
  "bodyfat": "31.29 %",
  "age": 33.0,
  "gender": "female",
  "bodyfat_status": "Obese",
  "bodyfat_percent": 31.29,
  "bmi_value": 24.98,
  "bodyfat_band": "obese",
  "bodyfat_band_label": "Obese",
  "risk_signal": "Adiposity risk is elevated.",
  "action_plan": ["Reduce visceral fat drivers", "Improve consistency"],
  "monitoring_plan": "Review trend every 4 weeks.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "6f143d4f3f26f891",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "Health Fitness API by Dakidarts®",
    "endpoint_name": "bodyfat",
    "response_language": "en"
  }
}

Valor do Produto

Útil para aplicativos de nutrição personalizados, painéis de bem-estar e sistemas de pontuação de prevenção.

Nota

A entrada permanece em métricas para os cálculos; units apenas altera o formato de exibição na resposta.

Endpoints Recomendados