Calculateur de poids d'armature

Une longueur ou un poids unitaire nul ou négatif est rejeté avec une erreur invalid_input claire au lieu d'inventer un bon de livraison à partir de quantités impossibles. Le chemin est purement mathématique et déterministe —sans réseau, sans graines aléatoires, sans dépendance à l'horloge— de sorte que l'exécuteur gratuit du navigateur et l'API prépayée renvoient le même JSON après un arrondi décimal fixe à chaque appel.

Comment le poids d'armature est calculé à partir de la longueur et du poids unitaire

En cas de succès la réponse renvoie les entrées arrondies, publie total_weight et weight comme le même produit, formula comme la chaîne W equals L times w, message comme un court résumé nommant le diamètre, et steps comme un tableau ordonné de lignes de substitution que vous pouvez affirmer dans des tests ou montrer à un client. Diamètre manquant ou vide, nombres non finis, et longueur ou poids unitaire non positifs échouent avec invalid_input afin de ne jamais facturer ni stocker une ligne de commande creuse.

Comment appeler l'API et ce qui est renvoyé

Le diamètre peut être une chaîne non vide ou un nombre fini converti en courte étiquette (soixante-quatre caractères maximum après trim). Les formes chaînes de nombres sont acceptées lorsqu'elles respectent un motif numérique fini strict. Préférez envoyer des nombres pour longueur et poids unitaire lorsque vous contrôlez le client ; si vous devez envoyer des chaînes, évitez les suffixes d'unité ou séparateurs de milliers qui feraient échouer le motif de nombre fini. Les poids unitaires impériaux typiques des diamètres courants aux États-Unis se situent à peu près entre trois dixièmes et treize livres par pied selon la taille ; utilisez toujours la valeur de tableau qui correspond au grade et à la norme de votre bon de commande, et non une règle mémorisée. Envoyez un corps JSON avec trois champs obligatoires : bar_size (alias size, designation, bar, rebar_size, bar_designation), total_length (alias length, total_length_ft, L, linear_feet, total_ft) et unit_weight_per_foot (alias unit_weight, weight_per_foot, plf, lb_per_ft, mass_per_length, w_per_ft). Longueur totale et poids unitaire doivent être des nombres finis positifs dans la plage absolue publiée afin que le produit reste fini en double précision IEEE sur le Worker et dans le navigateur. En cas de succès la réponse renseigne bar_size, total_length, unit_weight_per_foot, total_weight, weight, formula, message et steps. Une validation échouée —champs manquants, désignation vide, nombres non finis, longueur ou poids unitaire nuls ou négatifs, ou valeurs hors limites absolues— renvoie invalid_input et n'est jamais facturée. Le tarif est un forfait de $0.002 par requête réussie avec unité item.

Conseils pratiques, limites et recherches associées

Pour enseigner ou écrire des tests, associez un cas simple de dalle avec barres numéro cinq et un second poids unitaire pour montrer que le poids croît linéairement avec la longueur, et incluez volontairement une longueur ou un poids unitaire nuls pour prouver le chemin invalid_input. Les tâches en échec qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui maintient peu coûteux les scripts exploratoires lorsque vous envoyez volontairement une longueur nulle pour vérifier la gestion d'erreur. Les contrôles aller-retour sont simples : recalculez à la main longueur fois poids unitaire et confirmez que total_weight publié correspond au même arrondi à douze décimales utilisé pour tous les champs numériques. Les chantiers multi-diamètres se traitent en appelant une fois par diamètre et en sommant total_weight dans votre tableur ou estimateur, afin que chaque ligne reste transparente pour le ticket du parc à fer.