房贷月供计算(旧版,已弃用)
查看 美国房产与房贷数据 API 的全部接口 →此接口已弃用,仅为现有房贷计算器保留。请求包含六个必填数值型查询参数:downpayment 表示首付,hoi 表示住房保险输入值,price 表示房价,rate 表示利率,tax_rate 表示房产税输入值,term 表示房贷类型。排查旧系统时,应保留这些参数的原始名称。文档中的请求示例为 downpayment=44980、hoi=56、price=224900、rate=3.827、tax_rate=1.2485549449920654、term=30。这些数值仅是示例,不代表默认值,也不构成可选值清单。 文档响应示例包含 meta 和 mortgage 对象。mortgage 中展示了 down_payment、loan_amount、rate、term、principal_and_interest、monthly_property_taxes、monthly_home_insurance、monthly_mortgage_insurance、hoa_fees、monthly_payment 和 total_payment 等字段。monthly_* 字段名用于区分月度金额,principal_and_interest 则单独表示本金与利息部分。未经核实,不应将 monthly_payment、principal_and_interest 和 total_payment 视为相同金额,也不应推断各汇总字段包含哪些费用。 现有资料未提供此已弃用接口的成功验证记录,上述响应字段均来自未经验证的文档示例。简短的参数说明未明确币种、保险输入值的计费周期、利率数值尺度、房产税率单位或贷款期限单位;term 的示例值为 30,也不足以确定支持的期限列表。将旧版输入映射到当前计算器前,应先核对原应用的单位约定和还款金额涵盖的费用。此接口仅适用于旧系统梳理与迁移,不建议用于新建计算器,也不能作为利率数据源、贷款机构报价或贷款审批依据。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/realty-in-us/mortgage-calculate-deprecated API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/mortgage-calculate-deprecated?key=<API_KEY>&downpayment=<downpayment>&hoi=<hoi>&price=<price>&rate=<rate>&tax_rate=<tax_rate>&term=<term>'
查询结果
使用场景
- 调整参数映射前,排查仍在发送 downpayment、hoi 和 tax_rate 的旧版房贷组件。
- 根据已知贷款场景准备迁移测试样本,分别比较本息、房产税和保险字段。
- 检查现有界面是否误将 monthly_payment 与 total_payment 标注为可以互换的金额。
- 接入当前计算器前,记录旧应用的币种、保险周期、利率尺度、房产税单位和贷款期限约定。
- 为旧版解析器保留仅供文档测试的房贷响应样本,并明确其不属于经过核实的贷款机构估算。
常见问题
这个已弃用的房贷计算接口有哪些必填参数?
文档列出的六个查询参数均为必填数值:downpayment、hoi、price、rate、tax_rate 和 term。现有系统应保留这些参数的原始名称;文档示例值不保证是默认值。
hoi 是每月保险费吗?term 的单位是年吗?
现有参数说明没有明确这些输入单位。响应示例中虽有 monthly_home_insurance 字段,term 的示例值也为 30,但二者都不足以确定完整的输入约定。迁移前应核对原计算器实际使用的单位。
文档示例列出了哪些还款组成字段?
mortgage 对象包含 principal_and_interest、monthly_property_taxes、monthly_home_insurance、monthly_mortgage_insurance、hoa_fees、monthly_payment 和 total_payment,以及 down_payment、loan_amount、rate 和 term。这只是未经验证的示例,不保证实际响应一定包含这些字段。
可以把 monthly_payment 当作纯本金和利息吗?
不可以。示例分别列出了 principal_and_interest、monthly_payment 和 total_payment。为金额添加标签或与其他计算器比较前,应先核实每个字段的周期及所包含的费用。
这个接口适合用于新建贷款报价功能吗?
不适合。此接口已弃用,现有资料也没有成功验证记录。它仅适用于梳理旧版集成;当前计算接口需要另行验证,计算结果不能被表述为贷款机构报价或贷款审批结论。