Ir para o conteúdo

API DCN

Calcule a meta di calorias di um dia usando a equação de Mifflin ou Harris, multiplicador de atividade e ajuste de objetivo.

Endpoint

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

Parâmetros

Nome Tipo Obrigatório In Descrição
age inteiro Sim Query/Corpo Idade em anos.
weight número Sim Query/Corpo Peso em kg.
height número Sim Query/Corpo Altura em cm.
gender string (male,female) Sim Query/Corpo Sexo biológico.
activity_level string Sim Query/Corpo sedentary,lightly_active,moderately_active,very_active,extra_active.
goal string Não Query/Corpo weight_loss,maintenance,weight_gain.
equation string Não Query mifflin ou harris.
lang string Não Query Idioma da resposta (en,es,de,fr,pt,ja,hi,ar).

Por Que Usar Este Endpoint

  • Crie recomendações robustas de meta de calorias.
  • Mantenha a transparência da fórmula para conformidade e confiança.
  • Vincule metas de energia aos objetivos do usuário em uma única chamada de API.

Começar

Exemplo de Requisição

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

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.

{
  "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 do Produto

Valioso para SaaS de planejamento nutricional, ferramentas de atendimento ao paciente e produtos de coaching de fitness com metas de energia baseadas em objetivos.

Nota

equation é passado como parâmetro de query, mesmo para POST /dcn/post.

Endpoints Recomendados