Aller au contenu

API de calcul des protéines

Fournir des recommandations de protéines dans différents frameworks pour une planification nutritionnelle robuste.

Point de terminaison

  • GET /api/v1/protein-calculator
  • POST /api/v1/protein-calculator/post

Paramètres

Nom Type Obligatoire In Description
sex chaîne de caractères Oui Requête/Corps male ou female.
age nombre (>0) Oui Requête/Corps Âge en années.
height nombre (>0) Oui Requête/Corps Hauteur en cm (metric) ou pouces (imperial).
weight nombre (>0) Oui Requête/Corps Poids en kg (metric) ou lb (imperial).
activity_level chaîne de caractères Oui Requête/Corps sedentary,lightly_active,moderately_active,very_active,extra_active.
unit chaîne de caractères Non Requête/Corps metric (par défaut) ou imperial.
lang chaîne de caractères Non Requête Langue de la réponse (en,es,de,fr,pt,ja,hi,ar).

Pourquoi utiliser ce point de terminaison

  • Combiner les recommandations de protéines de base et de performance en une seule requête.
  • Soutenir les moteurs de macros et les plans de repas personnalisés.
  • Fournir des champs de guidance d'implémentation pour une clarté UX.

Commencer

Exemple de requête

curl -X GET "https://api.hefitapi.com/api/v1/protein-calculator?sex=male&age=34&height=178&weight=82&activity_level=very_active&unit=metric&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/protein-calculator/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"sex":"female","age":31,"height":66,"weight":148,"activity_level":"moderately_active","unit":"imperial"}'

Exemple de réponse

Info

L'exemple de réponse ci-dessous est uniquement à des fins de démonstration. Pour obtenir la structure JSON complète, en temps réel et potentiellement plus riche, effectuez une requête sur cet endpoint.

{
  "sex": "male",
  "age": 34.0,
  "height_cm": 178.0,
  "weight_kg": 82.0,
  "unit": "metric",
  "activity_level": "very_active",
  "tdee_kcal_per_day": 2949.41,
  "usda_protein_grams_range": [73.74, 221.21],
  "who_protein_grams": 68.06,
  "activity_target_protein_g": 131.2,
  "activity_target_g_per_kg": 1.6,
  "protein_band": "moderate",
  "protein_band_label": "Moderate",
  "distribution_guidance": ["Split protein across 3-5 meals"],
  "action_plan": ["Keep daily protein target consistent"],
  "quality_guardrails": ["Prioritize high-quality protein sources"],
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "dad775e89ecac88f", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "protein_calculator", "response_language": "en"}
}

Positionnement du produit

Un point de terminaison principal pour les produits nutritionnels, les plateformes de coaching et les applications de santé métabolique.

Note

L'âge, la taille et le poids doivent être des nombres positifs.

Points de terminaison recommandés