跳到主要内容
Housing Market GroupHousing Market Group教程

Housing Market API 课程 教程

面向开发者的房产数据：密钥、国家、方案和文档。

适用于开发者与数据团队。4 个章节，共 17 个教程。

从概览开始打开产品

您的进度: 已观看 0/17

1. 从这里开始

  1. Housing Market API 文档、PDF 指南与账单正在更新集成 Housing Market API 所需的一切都在控制台中：根据 API 实际运行的同一份规范生成的文档、供您自己的工具使用的 OpenAPI 文件，以及可下载为 PDF 的集成指南。您的银行卡和发票也只需一次点击即可查看。本教程将带您浏览文档、找到 OpenAPI 文件和指南，并展示账单所在的位置。
  2. 查看 Housing Market API 覆盖哪些国家正在更新Housing Market API 的覆盖范围页面列出该 API 可覆盖的所有国家，并按地区分组：亚太地区、中东、欧洲和美洲。每个国家的数据都来自 Housing Market Group 的门户，您可以逐个国家购买，也可以购买整个地区或全球覆盖。标记为正在更新的国家暂未开售。每个国家名称都会在新标签页中链接到对应门户，让您看到数据背后的房源。本教程将打开覆盖范围页面并逐一讲解。无需账户即可查看。

2. 您的账户

  1. 如何登录 Housing Market API 控制台正在更新在 Housing Market API 控制台中，您可以选择国家和方案、注册服务器地址、完成付款并获取 API 密钥。您使用 Housing Market 账户登录，即您在门户、CRM 或任何其他 Housing Market 产品中使用的同一邮箱和密码。本教程将打开控制台登录页面，说明需要填写的内容，并指出创建账户和忘记密码的链接，以及页眉中的语言菜单。
  2. 如何创建 Housing Market API 账户正在更新Housing Market API 让您的软件按国家获取 Housing Market 各门户已发布的房源。第一步是在 API 控制台注册账户。本教程打开注册页面，输入邮箱地址和密码，说明通过邮件收到的确认码，并介绍后续步骤。
  3. 在 Housing Market API 控制台中通过链接验证您的邮箱正在更新只要拥有账户，您就可以登录 Housing Market API 控制台，但只有在邮箱地址通过验证后才能使用它。本教程用一个尚未验证的地址登录，展示“请查收邮件”页面，申请新的验证邮件，演示如何更正输错的地址，然后打开邮件中的链接并点击其中的按钮。全程无需在任何地方输入验证码。
  4. 如何通过邮件链接创建 Housing Market API 账户正在更新Housing Market API 让您的软件按国家获取 Housing Market 各门户已发布的房源。第一步是在 API 控制台创建账户。本教程将打开注册页面，输入邮箱地址和密码，说明通过邮件发送的确认链接（无需输入验证码），并展示后续步骤。

3. 方案、国家与付款

  1. 如何为 Housing Market API 选择国家和方案正在更新Housing Market API 按覆盖范围销售：单个国家、整个区域或全球，可按月或按年计费。共有两种方案，Standard 包含房源及其全部详细信息，Advanced 在此基础上增加汇总的市场 Insights（上线后提供），两者价格相同。本教程将选择国家，比较区域与全球选项，挑选方案和计费周期，然后继续下一步。
  2. 如何添加国家或升级您的 Housing Market API 方案正在更新您的 Housing Market API 方案可以随您一同成长：添加一个国家、升级到区域或全球范围，或者升级到 Advanced，付款确认后同一个密钥即可覆盖新范围。本教程将打开方案变更页面、添加一个国家，并说明添加与移除如何计费。
  3. Housing Market API 价格：选择国家、地区或全球正在更新Housing Market API 按覆盖范围出售：单个国家、整个地区或全球，按月或按年计费。共有两种方案：Standard 包含房源及其全部详情，Advanced 在此基础上增加汇总的市场 Insights（上线即可使用），两者价格相同。本教程将选择国家，比较地区与全球两种选项，挑选方案和计费周期，然后继续下一步。
  4. 添加国家或升级您的 Housing Market API 方案（密钥不变）正在更新您的 Housing Market API 方案可以随您一同成长：添加一个国家、升级到区域或全球范围，或者升级到 Advanced，付款确认后同一个密钥即可覆盖新范围。本教程将打开方案变更页面、添加一个国家，并说明添加与移除如何计费。
  5. Housing Market API：付款未成功？重新付款正在更新如果您的 Housing Market API 方案首次付款未成功，控制台会在后台显示提示，并提供“重新付款”按钮。此时尚未创建任何 API 密钥，也没有保留任何内容，因此您可以用同一张卡或另一张卡重新尝试，付款成功后系统会立即创建您的密钥。本教程将向您展示该提示信息以及“重新付款”会带您去哪里。
  6. Housing Market API：在方案中添加或移除国家/地区正在更新在 Housing Market API 的国家/地区方案中，您可以在“您的国家/地区”页面添加或移除国家/地区。在产生任何费用之前，确认步骤会显示具体变更内容、添加时当即收取的金额、变更后的价格以及生效时间。本教程先添加一个国家/地区，然后介绍如何移除。

4. 密钥与第一次请求

  1. 如何为 Housing Market API 注册服务器 IP正在更新Housing Market API 密钥只能从您注册的那一个服务器地址使用，付款前您需要接受 API 条款。本教程演示如何填写服务器的 IP 地址，说明为什么浏览器显示的地址通常不是正确的地址，阅读条款步骤，并一直演示到安全支付页面。
  2. 如何获取您的 Housing Market API 密钥 —— 仅显示一次正在更新首笔付款确认后，您的 Housing Market API 密钥即已就绪，并且只会显示一次。本教程演示如何打开密钥、复制密钥，并说明应将其保存在何处，以及如何在每次请求中发送它。
  3. 您向 Housing Market API 发出的第一个请求正在更新拿到密钥后，一个 HTTPS 请求即可返回您已付费国家的房源数据。本教程将打开文档中的示例请求，用一次 ping 验证密钥，查询泰国的房源，解读响应内容及其游标，并获取下一页数据。
  4. Housing Market API 后台 — 用量、密钥轮换与 IP正在更新Housing Market API 后台会显示您的覆盖范围、今日和本月已用配额、您的密钥以及调用所使用的服务器地址。本教程讲解如何查看覆盖范围和用量表格、说明带 24 小时重叠期的密钥轮换，并演示如何更改已登记的服务器地址。
  5. Housing Market API：控制台中的公告正在更新当 Housing Market Group 有事项需要告知您时，例如一则通知或一次计划维护，它会以横幅形式显示在您 Housing Market API 控制台页头下方。本教程演示公告的样子、如何打开其中的“了解更多”链接，以及如何将其关闭，让它在该浏览器中不再打扰您。本视频中的公告均为示例。