Calculateur de besoins en assurance vie

Ce que signifie l'estimation de couverture style DIME

De nombreux foyers tiennent déjà un total unique de dettes en cours qui regroupe hypothèque et prêts d'études en une ligne, c'est pourquoi cette capacité utilise un contrat simplifié : annual_income, years_of_replacement et outstanding_debts. Les années de remplacement doivent être strictement positives — zéro ou négatif ne définit pas un horizon significatif et est rejeté comme invalid_input. En cas de succès, la réponse renvoie les trois entrées, signale income_replacement et recommended_coverage arrondis à deux décimales pour des comparaisons stables de type monétaire, et inclut une étiquette de méthode et une chaîne de formule que vous pouvez afficher à côté de la réponse.

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

Exemple : soixante-quinze mille de revenu annuel, dix ans de remplacement et cinquante mille de dettes donnent sept cent cinquante mille de remplacement de revenu et huit cent mille de couverture recommandée. La validation échouée n'est pas facturée. Envoyez par POST un corps JSON avec trois nombres finis obligatoires. annual_income est le revenu brut annuel à remplacer ; les alias income, yearly_income et salary sont acceptés pour que formulaires et tableurs réutilisent des noms de colonnes familiers. years_of_replacement est l'horizon en années ; les alias years, replacement_years et income_years mappent le même champ, et la valeur doit être supérieure à zéro sinon la tâche échoue avec invalid_input en nommant years_of_replacement. outstanding_debts est la somme des obligations que vous souhaitez que la police solde — reste d'hypothèque, prêts auto, cartes de crédit, prêts personnels — avec les alias debts, total_debt et debt. Chaque champ peut arriver en nombre JSON ou en chaîne numérique ; champs manquants, chaînes vides et valeurs non finies échouent avec invalid_input. annual_income ou outstanding_debts négatifs sont rejetés car, dans ce modèle, l'estimation de couverture ne peut partir d'une base de revenu ou de dettes négative. Lorsque la validation réussit, le corps renvoie annual_income, years_of_replacement, outstanding_debts, income_replacement (revenu fois années), recommended_coverage (income_replacement plus dettes), method avec une étiquette style DIME et formula qui reformule la forme fermée. Le chemin parse pur n'appelle jamais une API d'assureur, ne tire pas d'aléa et ne dépend pas de l'horloge système, de sorte que goldens et tests clients comparent octet par octet entre runtimes lorsqu'ils fixent les mêmes trois entrées.

Où une API de besoins en assurance vie trouve son utilité

Les foyers utilisent un calculateur de besoins en assurance vie lorsqu'un nouveau salaire, l'achat d'un logement ou un enfant force la première conversation sur le niveau de couverture qui maintiendrait les personnes à charge si le revenu s'arrêtait. Coaches et formateurs financiers ont besoin d'un oracle déterministe qui marque les années de remplacement non positives comme invalides au lieu de renvoyer silencieusement une couverture nulle qu'un formulaire bugué pourrait traiter comme un succès. Les équipes produit branchent le même contrat dans des assistants d'onboarding pour que l'utilisateur voie un capital assuré de départ avant qu'un souscripteur ou un agent le affine. Comme l'implémentation est parse pure de tier 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 petites, figez les recommended_coverage arrondis dans les tests, et vous obtenez des estimations reproductibles pour tableurs, plugins LMS et workers de bord sans déployer d'infrastructure actuarielle. Lorsque vous ajoutez plus tard des coûts d'éducation ou un champ hypothécaire séparé dans un tableur, incluez simplement ces soldes dans outstanding_debts ici pour que le total style DIME reste aligné sur le mnémonique complet tandis que la surface API reste à trois champs.