您需要本周可以直接放入应用程序的当前2年期抵押贷款利率。在本指南结束时,您将调用一个真实的端点,该端点返回2年期固定抵押贷款利率数据(包括提供商和示例付款),解析它,并交付一个有效的集成。
您从加拿大抵押贷款利率API中获得的内容
加拿大抵押贷款利率API按期限公开固定利率抵押贷款列表。它返回结构化的利率数组,包含贷方/提供商名称和示例定期付款。这对于以下内容很有用:
- 必须保持最新的利率比较小部件和着陆页。
- 用户选择期限和贷方的预资格流程。
- 抵押贷款市场中的潜在客户路由和利率警报电子邮件。
在Zyla API Hub上,您使用一个帐户、一个API密钥和一个跨越数千个API的订阅和配额模型。对于这个金融用例,我们将重点关注2年期端点,并注意同一列表中的3年期和5年期选项。
在Zyla API Hub上开始
打开API的市场页面并开始试用以获取您的密钥:
- 访问列表:在加拿大抵押贷款利率API上开始7天试用。
- 点击订阅或开始免费试用(如有提供)并复制您的API密钥。
- 使用Authorization: Bearer YOUR_API_KEY进行身份验证。
Zyla的计费是订阅+配额(而不是按调用计费)。请查看API页面以获取当前访问选项和定价。
您可以调用的端点
以下所有端点都是POST请求,并且根据文档,不需要请求参数。仅发送Authorization头。
2年期抵押贷款利率
- 方法:POST
- URL:https://zylalabs.com/api/5180/canada-mortgage-rates-api/11347/mortgage-rates-2-year
- 描述:返回2年期固定抵押贷款利率的列表,包含提供商名称和示例付款。
cURL示例(可复制粘贴):
curl -s -X POST "https://zylalabs.com/api/5180/canada-mortgage-rates-api/11347/mortgage-rates-2-year" \
-H "Authorization: Bearer YOUR_API_KEY"
3年期抵押贷款利率
- 方法:POST
- URL:https://zylalabs.com/api/5180/canada-mortgage-rates-api/11348/mortgage-rates-3-year
- 描述:返回3年期固定抵押贷款利率的列表,包含提供商名称和示例付款。
cURL示例:
5年期抵押贷款利率
- 方法:POST
- URL:https://zylalabs.com/api/5180/canada-mortgage-rates-api/11349/mortgage-rates-5-year
- 描述:返回5年期固定抵押贷款利率的列表,包含提供商名称和示例付款。
cURL示例:
官方2年期响应格式
以下是2年期端点的官方示例。使用它来构建您的模型和测试。
[
{
"best_2_year_fixed_mortgage_rates": [
{
"rate": "3.99%",
"provider": "大六银行",
"payment": "$2,077"
},
{
"rate": "4.09%",
"provider": "斯科舍银行",
"payment": "$2,098"
},
{
"rate": "4.49%",
"provider": "CanwiseA Ratehub.ca公司",
"payment": "$2,185"
},
{
"rate": "4.49%",
"provider": "加拿大贷方Ratehub.ca独家",
"payment": "$2,185"
},
{
"rate": "4.59%",
"provider": "TD银行",
"payment": "$2,207"
},
{
"rate": "4.64%",
"provider": "MCAP",
"payment": "$2,218"
},
{
"rate": "4.74%",
"provider": "第一国家",
"payment": "$2,240"
},
{
"rate": "4.79%",
"provider": "RBC皇家银行",
"payment": "$2,251"
},
{
"rate": "4.84%",
"provider": "加拿大国家银行",
"payment": "$2,263"
},
{
"rate": "4.93%",
"provider": "蒙特利尔银行",
"payment": "$2,283"
},
{
"rate": "5.14%",
"provider": "Alterna储蓄",
"payment": "$2,330"
},
{
"rate": "5.74%",
"provider": "梅里迪安信用合作社",
"payment": "$2,468"
},
{
"rate": "7.54%",
"provider": "ICICI银行加拿大",
"payment": "$2,901"
},
{
"rate": "4.49%",
"provider": "CIBC",
"payment": "$2,185"
},
{
"rate": "5.14%",
"provider": "橙色银行",
"payment": "$2,330"
},
{
"rate": "5.74%",
"provider": "Simplii金融",
"payment": "$2,468"
}
]
}
]
要阅读的内容:
- best_2_year_fixed_mortgage_rates:2年期的利率条目数组。
- 每个条目包括:
- rate:百分比字符串。
- provider:贷方或机构名称。
- payment:示例定期付款字符串,包括货币符号和分隔符,如所示。
Python示例:获取并显示最佳2年期固定利率
此脚本调用2年期端点,检查有效负载,并打印一个简单的比较列表。它仅使用文档中记录的URL和Authorization头。
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
URL = "https://zylalabs.com/api/5180/canada-mortgage-rates-api/11347/mortgage-rates-2-year"
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.post(URL, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()
# 根据官方示例进行防御性解析
rates = []
if isinstance(data, list) and data:
payload = data[0]
rates = payload.get("best_2_year_fixed_mortgage_rates", [])
# 打印紧凑的表格
for item in rates:
provider = item.get("provider")
rate = item.get("rate")
payment = item.get("payment")
print(f"{provider:<30} {rate:>6} {payment:>8}")
节省时间的实施说明
- 身份验证:在每个请求中发送Authorization: Bearer YOUR_API_KEY。
- 请求体:这些端点不需要任何请求体;请勿添加额外参数。
- 字符串和格式:利率和付款作为字符串返回(例如,"3.99%","$2,077")。如果需要数字比较,请在解析之前去除符号和分隔符。
- 货币和频率:付款值以格式化的货币字符串呈现。用于显示或小心推导数字;频率(每月/每两周)在示例中未指定,因此请勿假设。
- 更新和缓存:如果您的用户界面不需要每分钟的新鲜度,请在服务器端缓存响应(例如,几分钟)以减少调用和页面延迟。
- 分页:此处不适用;响应返回单个条目数组。
- 错误处理:将非2xx视为瞬态或身份验证失败。记录完整的响应体以进行调试,并在用户界面中显示用户友好的后备。
实际用例
- 着陆页模块:显示“今天最佳2年期固定利率”,并从数组中链接到完整表格。
- 预批准流程:让用户从提供商列表中选择2年期选项;在您的应用程序记录中保留选择和利率快照。
- 潜在客户分配:将潜在客户路由到在馈送中出现的贷方,附上显示的利率和付款字符串。
- 利率警报电子邮件:将今天的最高2年期利率与您存储的基准进行比较;如果百分比字符串下降,则触发通知。
超越2年期的扩展
如果您的旅程需要并排的期限比较,请调用3年期和5年期端点并呈现相邻的表格。由于这些端点共享相同的身份验证和无参数模式,您可以重用客户端代码,仅切换URL。
通过MCP从AI代理调用此API
您还可以通过AI编码代理使用Zyla MCP端点调用市场API。将您的客户端指向https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY,并配置一个工具,将其发布到所需的中心URL。有关如何将其接入您的开发环境的详细信息,请参见MCP页面。
为什么在Zyla API Hub上发布
- 一个API密钥和订阅模型,覆盖超过10,000个公共API。
- 一致的身份验证和请求模式简化您的后端代码。
- 在没有采购开销的情况下添加更多金融和支付功能。
在您需要扩展产品表面时,随时在Zyla API Hub上探索更多金融列表。
常见问题
2年期端点需要任何参数吗?
不需要。根据文档,发送仅带有Authorization头的POST请求。
我应该向用户显示哪些字段?
至少:提供商、利率和付款。如果您不需要数字计算,请保持利率和付款格式不变,因为它们已经包含符号和分隔符。
数据更新的频率是多少?
文档未指定更新频率。实施适合您用户界面需求的缓存,并定期检查端点。
有免费计划吗?
Zyla上的计划使用订阅+配额。请查看API页面以获取当前访问选项和定价。您可以在可用时从项目页面开始7天试用。
我可以在一个视图中比较2年期、3年期和5年期利率吗?
可以。独立调用这三个端点,并在相邻的表格或选项卡中呈现它们的数组。
准备好构建您的抵押贷款利率小部件或入职流程了吗?今天就开始与2年期端点的集成:打开加拿大抵押贷款利率API列表并开始7天试用。