按收入测算购房预算(旧版,已弃用)
查看 美国房产与房贷数据 API 的全部接口 →此旧版 GET 接口根据收入测算购房预算。必填参数包括 annual_income、monthly_debt、debt_to_income_ratio、down_payment、loan_term、interest_rate、tax_rate 和 homeowner_insurance_rate;hoa_fees 与 is_pmi_included 为可选参数。文档中的比率和利率示例采用小数形式,例如 0.43 表示 43% 的债务收入比,0.03119 表示 3.119% 的利率。迁移时需谨慎保留旧版标志参数:is_pmi_included 的说明将其与服役情况关联,并称设为 false 时会将 down_payment 置为零,这与参数名称的表面含义存在冲突,且该行为尚未验证。 现有资料没有此已弃用接口的实测响应。未经验证且不完整的文档示例包含 affordability 对象,其中展示了 calculated_price、debt_to_income_ratio、house_expenses_ratio、hoa_fees、monthly_payment、principal_and_interest、monthly_property_taxes、monthly_home_insurance 和 monthly_mortgage_insurance。示例还包含以数字字符串为键的 range 对象,其嵌套的购房预算明细沿用相同字段。尽管输入示例采用小数,输出示例中的债务收入比却采用百分数数值形式。因此,不能假设输入和输出使用相同的比率尺度;该样本也不足以确定 range 的完整覆盖范围或完整响应结构。 此接口仅用于记录与迁移现有购房预算集成,不建议用于新开发。房贷月供计算与根据收入估算购房预算回答的是不同问题,不能直接视为等价替代。这些计算数值不代表贷款资格认定、贷款审核通过或贷款机构报价。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/realty-in-us/mortgage-calculate-affordability-deprecated API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/mortgage-calculate-affordability-deprecated?key=<API_KEY>&annual_income=<annual_income>&debt_to_income_ratio=<debt_to_income_ratio>&down_payment=<down_payment>&homeowner_insurance_rate=<homeowner_insurance_rate>&interest_rate=<interest_rate>&loan_term=<loan_term>&monthly_debt=<monthly_debt>&tax_rate=<tax_rate>'
查询结果
使用场景
- 停用旧版购房预算请求前,盘点原工具采用的收入、债务和比率假设。
- 在迁移清单中保留房产税、保险及业主协会费用输入,避免替代方案悄然低估住房支出。
- 为文档中的 affordability 对象和嵌套 range 条目建立明确标注的离线解析测试样本,不将其展示为实测结果。
- 先核查含义不明确的 is_pmi_included 标志与基于收入的预算需求,再判断经过独立验证的月供计算器是否足以替代。
常见问题
新建购房预算工具应使用这个接口吗?
不应使用。此接口已弃用,仅为旧系统迁移保留。现有资料没有它的实测响应,可用的替代方案需要另行验证。
债务收入比和各项费率应采用什么数值形式?
文档输入采用小数:debt_to_income_ratio 为 0.43 时表示 43%,interest_rate 为 0.03119 时表示 3.119%,tax_rate 为 0.01 时表示 1%,homeowner_insurance_rate 为 0.012 时表示 1.2%。但留存的响应示例将 debt_to_income_ratio 写成百分数数值形式,因此不能假定输入和输出使用相同的数值尺度。
is_pmi_included 能可靠地控制私人房贷保险吗?
现有资料无法确认这一含义。虽然参数名称看起来与私人房贷保险有关,旧版说明却提到服役情况,并称 false 会将 down_payment 置为零。应谨慎保留现有调用方式,在将其用于保险或贷款资格判断前验证实际行为。
文档列出了哪些购房预算响应字段?
未经验证的示例展示了 affordability.calculated_price、monthly_payment、principal_and_interest、monthly_property_taxes、monthly_home_insurance、monthly_mortgage_insurance、hoa_fees、debt_to_income_ratio 和 house_expenses_ratio。range 对象中也包含类似结构的明细。该示例不完整,不能据此确认字段或区间的完整覆盖范围。
房贷月供估算能替代这个结果或用于批准贷款吗?
不能直接替代。此请求利用收入和现有债务估算购房预算,而月供估算回答的是另一个问题。无论是旧版购房预算结果还是还款计算,都不构成贷款审核通过的结论或具有约束力的贷款报价。