Ir para o conteúdo

API FFMI

Calcule as métricas de FFMI com saída formatada opcional e suporte de unidades para entradas métricas ou imperiais.

Endpoint

  • GET /api/v1/ffmi
  • POST /api/v1/ffmi/post

Parâmetros

Nome Tipo Obrigatório In Descrição
sex string (male,female) Sim Query/Corpo Sexo biológico.
height número Sim Query/Corpo Altura (cm métrica, in imperial).
weight número Sim Query/Corpo Peso (kg métrico, lb imperial).
body_fat número Sim Query/Corpo Percentagem de gordura corporal.
unit string (metric,imperial) Não Query/Corpo Modo de entrada. Valor padrão: metric.
format string (yes,no) Não Query/Corpo Interruptor de formatação de saída.
lang string Não Query Idioma da resposta (en,es,de,fr,pt,ja,hi,ar).

Por que Usar Este Endpoint

  • Adicione a pontuação de qualidade de massa magra aos produtos de composição corporal.
  • Compare o FFMI bruto vs normalizado para benchmarking justo.
  • Habilite insights para atletas com faixas específicas por sexo.

Comece agora

Exemplo de Solicitação

curl -X GET "https://api.hefitapi.com/api/v1/ffmi?sex=male&height=178&weight=82&body_fat=16&unit=metric&format=yes&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/ffmi/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"sex":"male","height":178,"weight":82,"body_fat":16,"unit":"metric","format":"yes"}'

Exemplo de Resposta

Info

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

{
  "FFMI": "19.38 kg/m2",
  "Normalized FFMI": "19.51 kg/m2",
  "Fat-free mass": "68.88 kg",
  "Total body fat": "13.12 kg",
  "Sex": "male",
  "Unit": "metric",
  "ffmi_value": 19.38,
  "normalized_ffmi_value": 19.51,
  "fat_free_mass_kg": 68.88,
  "total_body_fat_kg": 13.12,
  "ffmi_band": "standard",
  "ffmi_band_label": "Standard",
  "risk_signal": "Lean mass status is within expected range.",
  "action_plan": ["Progress overload gradually"],
  "monitoring_plan": "Track every mesocycle.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "de948be84a08433f",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "ffmi",
    "response_language": "en"
  }
}

Posicionamento Comercial

Perfeito para análises avançadas de físico, produtos de treinamento de força e pilhas de monitoramento de atletas.

Nota

format=no retorna uma representação numérica não string para os campos de exibição de nível superior do FFMI.

Endpoints Recomendados