Calculateur de glucides nets

Ce calculateur de glucides nets accepte les grammes de glucides totaux, de fibres alimentaires et d'alcools de sucre (polyols), puis renvoie une valeur déterministe net_carbs avec la formule reformulée pour l'affichage. Un total non positif, des fibres ou polyols négatifs, et des combinaisons impossibles où fibres plus polyols dépassent le total échouent avec invalid_input au lieu d'inventer un résultat négatif.

Ce que signifient les glucides nets et comment la formule s'applique

L'arithmétique est délibérément simple : net_carbs égale total_carbs moins fiber moins sugar_alcohols, chaque quantité en grammes pour une portion ou une entrée alimentaire. Ce endpoint met en œuvre exactement cette convention grand public, sans estimer l'index glycémique, sans convertir d'unités et sans deviner des champs d'étiquette manquants. Si fibres plus alcools dépassent le total, la combinaison ne peut pas provenir d'une étiquette cohérente, donc la tâche échoue avec invalid_input plutôt que de renvoyer un net négatif qui brouillerait journaux et tableaux de bord.

Contrat d'entrée, forme de la réponse et comportement d'erreur

Exemple : vingt-cinq grammes de glucides totaux, huit de fibres et cinq d'alcools de sucre donnent douze grammes de glucides nets. L'échec de validation n'est pas facturé. La capacité ne recherche pas de produits, ne racle pas de bases de données et n'ajuste pas les demi-comptes de marque de certains polyols ; si votre protocole soustrait seulement la moitié des alcools de sucre, appliquez ce facteur avant l'appel ou après réception de la figure nette brute. Envoyez par POST un corps JSON avec trois champs obligatoires : total_carbs, fiber et sugar_alcohols. Chacun peut arriver comme nombre JSON ou comme chaîne numérique ; booléens, chaînes vides, NaN et Infinity échouent avec invalid_input en nommant le champ. Des alias sont acceptés pour le transport : carbs, carbohydrate, total_carbohydrate, carbohydrate_g et carbs_g correspondent à total_carbs ; fiber_g, dietary_fiber, fibre et fibre_g à fiber ; sugar_alcohols_g, polyols, polyol_g et sugar_alcohol à sugar_alcohols. En cas de succès le corps renvoie les valeurs nettoyées de total_carbs, fiber et sugar_alcohols, le net_carbs calculé, une courte chaîne formula et unit en g. Exemple sans polyols : quarante de total, dix de fibres et zéro d'alcools donnent trente grammes nets. Associez le résultat à votre interface de journal, cache de codes-barres ou mise à l'échelle de recettes ; ce endpoint n'effectue que l'arithmétique en grammes.

Où un calculateur de glucides nets apporte une vraie valeur

Les applications de planification de repas et les coachs cétogènes utilisent un calculateur de glucides nets pour coller les chiffres de l'étiquette et rester sous un budget quotidien de nets sans erreurs de tableur. Les agrégateurs de restaurants et de livraison normalisent les macros fournisseurs en glucides nets pour des filtres tels que moins de dix grammes nets, ce qui exige une seule fonction déterministe plutôt qu'un code ad hoc sur chaque plateforme. Les outils d'éducation sur la glycémie continue et le diabète enseignent souvent la lecture d'étiquettes en montrant total versus net côte à côte ; une API partagée garde identiques la démo en classe et le backend de production. Comme l'implémentation est pure parse de niveau A, chaque appel réussi coûte le prix de base publié $0.002, sans jetons de modèle ni réseau sortant. Gardez les requêtes compactes, figez net_carbs attendu dans les tests et vous obtenez des résultats reproductibles pour clients mobiles, workers serverless et importateurs par lots sans monter votre propre base nutritionnelle.