Percentile de revenu des ménages US

Un revenu manquant, un revenu négatif et les nombres non finis échouent avec invalid_input et ne sont pas facturés. Les appels réussis sont facturés à $0.002.

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

Les magnitudes au-delà de la limite publiée échouent aussi. Exemple : quatre-vingt mille dollars tombent sur le nœud médian et renvoient percentile 50, rank 50th et band middle. Deux cent vingt-cinq mille dollars se situent à mi-chemin entre les nœuds de deux cent mille et de deux cent cinquante mille et renvoient percentile 87. Associez le rang à vos propres notes de coût de la vie si vous avez besoin d’un contexte régional ; ce point d’accès ne classe que face à une table nationale des ménages. Envoyez par POST un corps JSON avec un champ obligatoire : income, le revenu annuel du ménage aux États-Unis, en dollars. Il doit s’agir d’un nombre fini non négatif ; les alias annual_income, household_income, amount et salary sont acceptés afin qu’une ligne de paie n’ait pas besoin d’une étape de rename. Les nombres JSON sont préférés ; les chaînes numériques qui s’analysent comme un décimal fini sont acceptées. Un revenu manquant, une chaîne vide, NaN, Infinity, une valeur non numérique ou un montant négatif échouent avec invalid_input en nommant le champ et ne sont pas facturés, car un percentile n’est pas défini pour un revenu de ménage négatif sur cette table. En cas de succès le corps répète income, puis renvoie percentile comme le rang interpolé sur une échelle 0–100, percentile_rounded comme l’entier le plus proche, rank comme l’ordinal anglais de cet entier — par exemple 50th ou 91st —, share_below égal au percentile, share_above égal à 100 moins le percentile, et band comme une étiquette grossière telle que bottom_20, lower_middle, middle, upper_middle, top_20, top_10, top_5 ou top_1. La réponse nomme aussi les nœuds d’encadrement lower_income, lower_percentile, upper_income et upper_percentile, plus method linear_interpolation et une chaîne formula que vous pouvez afficher à côté de la réponse. Le prix d’un élément réussi est un $0.002 forfaitaire.

Où un calculateur de percentile de revenu aux États-Unis trouve sa place

Les cours de mathématiques du consommateur assignent des feuilles de distribution et ont besoin d’un oracle qui marque un revenu négatif comme invalid_input au lieu de le raboter à zéro en silence. Les tableaux de rémunération et les carnets de budget ménager appellent le même contrat à $0.002 par élément réussi sans dresser un pipeline de téléchargement du Census. Gardez les requêtes petites, figez le percentile interpolé dans les tests, et vous obtenez un rang reproductible des ménages américains pour des articles, des lettres d’offre et des webhooks financiers légers, sans prétendre que la table soit les microdonnées de l’enquête de cette année.