Calculateur de sucres ajoutés

Le parcours est une arithmétique purement déterministe, sans appels réseau ni graine aléatoire, de sorte que les applications de coaching, les planificateurs de repas et les clients d'API prépayée reçoivent toujours le même JSON. Un apport calorique non positif est rejeté comme invalid_input car un budget énergétique nul ou négatif ne peut pas définir une ration de sucre.

Ce que mesure le calculateur et quelles entrées vous devez fournir

Envoyez calorie_intake comme nombre fini positif de kilocalories par jour ; les alias calories, kcal, energy_kcal et calorie_intake_kcal sont acceptés afin que les applications bien-être mappent des noms de champs déjà existants sans renommer les charges utiles. Envoyez guideline_percentage comme nombre fini positif strictement supérieur à zéro et au plus égal à cent ; si vous l'omettez, le moteur utilise dix, le plafond énergétique habituel OMS et FDA. Les alias percent, pct, sugar_percent et added_sugar_percent pointent vers le même champ. Un apport calorique manquant, des chaînes vides, des nombres non finis et tout apport calorique nul ou négatif échouent avec invalid_input et ne sont pas facturés. Des entrées identiques produisent toujours le même JSON car le parcours ne touche jamais le réseau, un modèle de langage, une horloge ni un générateur aléatoire.

Lire les champs de réponse et les pièges courants

En cas de succès, la réponse renvoie l'écho de calorie_intake_kcal et guideline_percentage, puis sugar_kcal (la part énergétique allouée aux sucres ajoutés), max_added_sugar_g (le plafond principal en grammes) et teaspoons à raison de quatre grammes par cuillère à café, pour comparer les cuillères de cuisine aux étiquettes. Le champ kcal_per_gram vaut toujours quatre, unit vaut toujours g/day, formula reformule que les grammes égalent calories fois pourcentage sur cent sur quatre, et method est toujours energy_percent_added_sugar afin que le code en aval branche sans renifler les formes. Utilisez max_added_sugar_g lorsqu'un planificateur de repas n'a besoin que d'un plafond quotidien scalable ; utilisez sugar_kcal lorsque les supports pédagogiques doivent montrer le budget énergétique à côté du nombre en grammes ; utilisez teaspoons lorsque vous parlez à des personnes qui pensent en cuillères plutôt qu'en grammes.

Usage de l'API, tarification, flux de coaching et limites pratiques

Appelez le calculateur gratuit d'apport en sucre dans le navigateur pour des vérifications rapides, l'éducation client, des démos de cours et la planification des étiquettes d'épicerie sans installer de tableur nutritionnel. Préférez des apports caloriques qui correspondent déjà à l'estimation énergétique quotidienne de votre produit—si vous ne connaissez que les macros, convertissez-les en kilocalories avant d'appeler. Gardez des attentes éducatives : c'est un outil de planification et de littératie, pas un dispositif médical de diagnostic, et les utilisateurs aux besoins atypiques doivent suivre un avis clinique plutôt qu'une seule formule isolée. Dix pour cent de deux mille calories font cinquante grammes ; cinq pour cent font vingt-cinq grammes ; ces deux jalons sont ceux que citent la plupart des pages de santé publique, et ce calculateur les reproduit exactement pour que votre interface ne diverge jamais d'une note de bas d'étiquette. Envoyez un corps JSON avec calorie_intake requis (ou un alias) et, en option, guideline_percentage. Utilisez l'API prépayée lorsqu'un SaaS bien-être, un formulaire de télésanté, un planificateur de cantine scolaire ou un pipeline de suivi calorique a besoin d'un contrat stable à $0.002 par élément réussi ; les échecs de validation ne consomment jamais le solde après le rejet du moteur. Associez ce point de terminaison à votre base de journal alimentaire : calculez ici le plafond en grammes, puis scorez les sucres ajoutés enregistrés par rapport à max_added_sugar_g côté client. Les auteurs de SDK peuvent mapper max_added_sugar_g, sugar_kcal et teaspoons vers des cartes de tableau de bord et des colonnes CSV étiquetées plafond en grammes, énergie du sucre et cuillères—les mêmes chiffres que les diététiciens calculent à la main en appliquant dix pour cent des calories divisés par quatre sur papier.