住居費負担率の計算

成功した API 呼び出しは$0.002で課金され、不正な入力は課金されません。

住居費負担率が測るものと計算の仕方

恒等式は housing_cost_ratio が housing_cost を income で割った値であり、両金額は同じ通貨かつ同じ期間を使います。HUD はさらに、所得の 30 パーセント超を住居に使う世帯を cost-burdened、50 パーセント超を使う世帯を severely_cost_burdened とラベルします。この二つの区切りは計算した比率への分類ラベルであり、割り算そのものは変えません。この計算機は呼び出し側が渡す目標（既定 0.30）とも比率を比べ、その目標をなお満たす最大住居費と、その上限と実際の支払額の符号付き余裕も返します。

入力契約、応答の形、検証

income はその期間の世帯税引前所得で、住居費負担率がその値で割るため、ゼロより真に大きくなければなりません。住居費ゼロは有効で、比率はゼロになります。ゼロの直後から 1 までの区間の値は小数として扱います（0.28 は二十八パーセント）。1 より大きく 100 以下の値はパーセントとして扱うため、30 は 0.30 と同じ上限です。ドル記号と桁区切りは解析しません。同じ通貨・同じ期間の有限な必須数値を二つ含む JSON 本体を送ってください。給与の書き出しで名前を変えなくて済むよう、別名 gross_income、gross、monthly_income を受け付けます。housing_cost は同じ期間の総住居費で、ゼロ以上でなければなりません。別名 housing、total_housing、housing_costs を受け付けます。任意の target_ratio は合格フラグと負担可能な住居費の行に使う上限で、既定は 0.30 です。別名 target、ratio_limit、max_ratio は target_ratio に対応します。target_percent と max_percent はすでにパーセントの数字として読み、target_ratio が無いときに百で割ります。任意の precision（別名 decimals、dp）は 0 から 15 の整数で、数値出力の小数桁を決め、既定は 4 です。各数値欄は JSON の数でも数字の文字列でも構いません。絶対値は千兆以内に収め、中間積が Worker とブラウザの IEEE 倍精度で有限に保たれるようにします。欠けた欄、空文字、非有限値、正でない所得、負の住居費、正でない目標、範囲外の値は、欄名を付けた invalid_input で失敗し、課金されません。成功時は丸めた income と housing_cost を返し、housing_cost_ratio と housing_cost_percent を返し、解決した target_ratio と target_percent を返し、income に目標を掛けた affordable_housing_cost、その上限から実際の住居費を引いた headroom、負でない超過分 over_budget、丸め前の比率と目標を比べた真偽値 passes、HUD 風の状態文字列（affordable、cost_burdened、severely_cost_burdened）、公式文字列、使った精度を返します。通貨形式の文字列より JSON の数を使ってください。成功した一件の料金は一律 $0.002 です。

住居費負担率の計算機が役立つ場面

実装は純粋な parse のティア A のため、成功した呼び出しは毎回、公表された基本料金 $0.002 で、モデルのトークンも外向きの通信もありません。