Ir para o conteúdo

API IBW

Calcule o peso ideal em kg e lb, com lógica opcional ajustada para quadris, para calculadoras de treino e clínicas.

Endpoint

  • GET /api/v1/ibw
  • POST /api/v1/ibw/post

Parâmetros

Nome Tipo Obrigatório In Descrição
height número (>0) Sim Consulta/Corpo Altura em centímetros.
body_frame string Sim Consulta/Corpo small,medium,large.
gender string Sim Consulta/Corpo male ou female.
formula string Não Consulta hamwi (padrão) ou devine.
lang string Não Consulta Idioma da resposta (en,es,de,fr,pt,ja,hi,ar).

Por que Usar Este Endpoint

  • Padronizar a estimativa do IBW em diferentes produtos.
  • Suportar resultados específicos de fórmulas para contextos clínicos e de fitness.
  • Adicionar precisão e orientação para metas de peso.

Começar

Exemplo de Requisição

curl -X GET "https://api.hefitapi.com/api/v1/ibw?height=176&body_frame=medium&gender=male&formula=hamwi&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/ibw/post?formula=devine&lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"height":165,"body_frame":"small","gender":"female"}'

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.

{
  "ideal_weight": "69.42 kg",
  "formula": "Hamwi",
  "gender": "Male",
  "body_frame": "Medium",
  "ideal_weight_kg": 69.42,
  "ideal_weight_lb": 153.04,
  "height_cm": 176.0,
  "height_m": 1.76,
  "precision_band": "frame_adjusted",
  "precision_label": "Frame Adjusted",
  "risk_signal": "Reference target suitable for phased planning.",
  "action_plan": ["Set sustainable weekly target range"],
  "monitoring_plan": "Reassess with body composition and performance markers.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "146e3a98a9a8ec1c",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "ibw",
    "response_language": "en"
  }
}

Posicionamento do Produto

Útil para formulários de avaliação, planos de treino digitais e fluxos de trabalho de triagem de saúde que necessitam de estimativas normalizadas do IBW.

Nota

height, body_frame e gender são obrigatórios para tanto GET quanto POST.

Endpoints Recomendados