Saltar a contenido

API de DCN

Calcular el objetivo de calorías diario utilizando la ecuación de Mifflin o Harris, multiplicador de actividad y ajuste de objetivos.

Endpoint

  • GET /api/v1/dcn
  • POST /api/v1/dcn/post

Parámetros

Nombre Tipo Requerido En Descripción
age entero Sí Consulta/Cuerpo Edad en años.
weight número Sí Consulta/Cuerpo Peso en kg.
height número Sí Consulta/Cuerpo Altura en cm.
gender cadena (male,female) Sí Consulta/Cuerpo Sexo biológico.
activity_level cadena Sí Consulta/Cuerpo sedentary,lightly_active,moderately_active,very_active,extra_active.
goal cadena No Consulta/Cuerpo weight_loss,maintenance,weight_gain.
equation cadena No Consulta mifflin o harris.
lang cadena No Consulta Idioma de la respuesta (en,es,de,fr,pt,ja,hi,ar).

¿Por qué usar este endpoint?

  • Crear recomendaciones robustas de objetivos de calorías.
  • Mantener la transparencia de la fórmula para el cumplimiento y la confianza.
  • Vincular los objetivos de energía a los objetivos del usuario en una sola llamada a la API.

Comenzar

Ejemplo de solicitud

curl -X GET "https://api.hefitapi.com/api/v1/dcn?age=36&weight=81&height=177&gender=male&activity_level=moderately_active&goal=maintenance&equation=mifflin&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/dcn/post?equation=mifflin&lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"age":36,"weight":81,"height":177,"gender":"male","activity_level":"moderately_active","goal":"maintenance"}'

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 en vivo a este endpoint.

{
  "caloric_needs": {
    "equation": "mifflin",
    "goal": "maintenance",
    "calories": "2762.15 kcal/day"
  },
  "daily_calorie_target_kcal": 2762.15,
  "bmr_kcal_per_day": 1782.03,
  "activity_multiplier": 1.55,
  "profile": {
    "age": 36,
    "weight_kg": 81.0,
    "height_cm": 177.0,
    "gender": "male",
    "activity_level": "moderately_active",
    "goal": "maintenance",
    "equation": "mifflin"
  },
  "energy_band": "high",
  "energy_band_label": "High",
  "risk_signal": "Higher intake precision required.",
  "action_plan": ["Track trend weekly"],
  "monitoring_plan": "Adjust if weight trend drifts.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "bc434f88c1116d94",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "dcn",
    "response_language": "en"
  }
}

Valor del producto

Valioso para SaaS de planificación nutricional, herramientas de atención al paciente y productos de entrenamiento con objetivos de energía basados en objetivos.

Nota

equation se pasa como parámetro de consulta incluso para POST /dcn/post.

Endpoints recomendados