Calculateur de supports de gouttière

Un entraxe nul ou négatif est rejeté avec une erreur invalid_input claire au lieu d’inventer une infinité de supports, et une longueur non positive est rejetée de la même façon. Le chemin est une mathématique pure 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 l’arrondi décimal fixe à chaque appel.

Comment compter les supports de gouttière à partir de la longueur et de l’entraxe

L’entraxe doit être strictement positif : un entraxe nul impliquerait une infinité de supports, et un entraxe négatif n’a aucun sens physique sur une ligne, donc les deux cas renvoient invalid_input. En cas de succès l’outil renvoie longueur et entraxe arrondis, publie intervals, hangers_base, hangers_needed, extra_hangers, formula, message et steps pour que vous puissiez auditer l’arithmétique à la main ou dans des tests automatisés.

Comment appeler l’API et ce qu’elle renvoie

Préférez envoyer des nombres plutôt que des chaînes préformatées lorsque vous contrôlez le client ; si vous devez envoyer des chaînes, évitez les suffixes d’unité ou les séparateurs de milliers qui feraient échouer le motif de nombre fini. Exemples typiques : quarante pieds de gouttière à deux pieds d’entraxe donnent vingt et un supports ; trente mètres à zéro virgule six mètres donnent cinquante et un supports sur la grille de base avant extras. Envoyez un corps JSON avec deux champs obligatoires : gutter_length (alias length, L, run, run_length, gutter, total_length) et hanger_spacing (alias spacing, space, gap, S, interval, bracket_spacing). Envoyez éventuellement extra_hangers (alias extras, spare, spares, extra, additional) ; s’il est omis, la valeur par défaut est zéro. Longueur et entraxe doivent être des nombres finis positifs dans la plage absolue publiée afin que le rapport et les comptes restent finis en double précision IEEE sur le Worker et dans le navigateur. extra_hangers, lorsqu’il est fourni, doit être un entier non négatif jusqu’au maximum publié ; les formes en chaîne d’entiers sont acceptées si elles correspondent à un motif numérique fini strict, mais les extras fractionnaires sont rejetés. En cas de succès la réponse fixe intervals au nombre de travées entre supports, hangers_base à intervals plus un, hangers_needed à hangers_base plus extra_hangers, formula à l’expression publiée, message à un bref résumé et steps à un journal ordonné de substitution. Une validation échouée—champs manquants, nombres non finis, entraxe nul ou négatif, longueur non positive, extra_hangers invalide 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

Mesurez chaque tronçon droit d’avant-toit séparément et n’additionnez les supports qu’après avoir compté les angles avec soin—les points de mitre partagés peuvent exiger un crochet supplémentaire que la formule de tronçon droit n’invente pas pour vous, d’où l’existence de extra_hangers. Choisissez l’entraxe d’après la fiche fabricant ou la pratique locale : vingt-quatre pouces est courant pour de nombreux systèmes résidentiels de style K, tandis que certains produits en aluminium autorisent trente ou trente-six pouces dans les régions à faible neige ; gardez toujours longueur et entraxe dans la même unité avant d’appeler l’API. Pour enseigner ou écrire des tests, associez un multiple exact (longueur 40, entraxe 2 → vingt et un supports) à un cas non exact qui exerce le plafond, et incluez un entraxe nul ou négatif volontaire 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 un entraxe zéro pour vérifier la gestion d’erreurs.