API para la Estimación de Grasa Corporal (Entradas en Metros)¶
Estima el porcentaje de grasa corporal a partir de entradas basadas en el modelo de IMC y devuelve bandas de clasificación específicas por sexo.
Endpoint¶
GET /api/v1/bodyfatPOST /api/v1/bodyfat/post
Parámetros¶
| Nombre | Tipo | Requerido | In | Descripción |
|---|---|---|---|---|
gender | string (male,female) | Sí | Consulta/Cuerpo | Sexo biológico. |
age | número | Sí | Consulta/Cuerpo | Edad en años. |
height | número | Sí | Consulta/Cuerpo | Altura en centímetros. |
weight | número | Sí | Consulta/Cuerpo | Peso en kilogramos. |
units | string (metric,imperial) | No | Consulta/Cuerpo | Formato de visualización de la salida solo. Por defecto, metric. |
lang | string | No | Consulta | Idioma de la respuesta (en,es,de,fr,pt,ja,hi,ar). |
¿Por qué usar este endpoint?¶
- Añade la estimación de la grasa corporal sin dispositivos de medición de pliegues cutáneos.
- Segmenta a los usuarios por bandas de adiposidad para la automatización del coaching.
- Combina con los endpoints de IMC/BMR para obtener un contexto completo de la composición corporal.
Ejemplo de Solicitud¶
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"}'
Ejemplo de Respuesta¶
Info
El ejemplo de respuesta a continuación es solo para demostración. Para recibir la estructura JSON completa, en tiempo real y potencialmente más rica, realice una solicitud real a 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 del Producto¶
Útil para aplicaciones de nutrición personalizadas, paneles de bienestar y sistemas de puntuación de atención preventiva.
Nota
La entrada permanece en unidades métricas para los cálculos; units solo modifica el formato de visualización en la respuesta.
Endpoints Recomendados¶
GET /api/v1/bodyfat/army- API Bodyfat ArmyGET /api/v1/bodyfat_imperial- API Bodyfat ImperialGET /api/v1/bodyfat/navy- API Bodyfat NavyGET /api/v1/bmi- API BmiGET /api/v1/tdee- API TdeeGET /api/v1/bmr- API Bmr