Saltar a contenido

API de FFMI

Calcule las métricas de FFMI con salida formateada opcional y soporte para unidades de entrada, tanto métricas como imperiales.

Endpoint

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

Parámetros

Nombre Tipo Obligatorio In Descripción
sex string (male,female) Sí Consulta/Cuerpo Sexo biológico.
height número Sí Consulta/Cuerpo Altura (cm métrica, in imperial).
weight número Sí Consulta/Cuerpo Peso (kg métrico, lb imperial).
body_fat número Sí Consulta/Cuerpo Porcentaje de grasa corporal.
unit string (metric,imperial) No Consulta/Cuerpo Modo de entrada. Predeterminado metric.
format string (yes,no) No Consulta/Cuerpo Interruptor de formato de salida.
lang string No Consulta Idioma de la respuesta (en,es,de,fr,pt,ja,hi,ar).

¿Por qué utilizar este endpoint?

  • Añadir una puntuación de calidad de masa magra a los productos de composición corporal.
  • Comparar el FFMI bruto frente al normalizado para un benchmarking justo.
  • Permitir obtener información específica para atletas, con rangos específicos para cada sexo.

Comenzar

Ejemplo de solicitud

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"}'

Ejemplo de respuesta

Info

El ejemplo de respuesta a continuación es solo para demostración. Para obtener la estructura JSON completa, en tiempo real y potencialmente más rica, realice una solicitud real a 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"
  }
}

Posicionamiento comercial

Perfecto para análisis avanzados de la composición física, productos de entrenamiento de fuerza y ​​pilares de monitorización de atletas.

Nota

format=no devuelve una representación numérica no de cadena para los campos principales de visualización de FFMI.

Endpoints recomendados