Housing Market API 集成指南

获取密钥

在控制台中订阅即可获得密钥。无需排队等待审批，也无需发送电子邮件。

1. 登录控制台，或创建账户。该账户与您用于其他 Housing Market 产品的账户相同。
2. 选择国家（单个国家、某个区域或全球）、版本，以及按月或按年计费。
3. 输入您的服务器调用 API 时使用的 IP 地址。
4. 接受 API 使用条款。我们会记录您接受的内容和时间。
5. 付款。只有在付款成功后才会显示您的密钥，且仅显示一次。

请将密钥直接复制到您的密钥存储中。我们只保存其单向哈希值，因此无法再次向您显示。密钥格式如 hma_<prefix>_<secret>。

您可以随时在控制台中创建替换密钥。创建后，旧密钥将继续有效 24 小时，以便您在不中断服务的情况下完成切换。

密钥状态

• 有效：密钥可正常使用。
• 已暂停：密钥会被拒绝并返回 key_paused。原因解决后会自动恢复。
• 已吊销：密钥会被永久拒绝并返回 unauthenticated。

如果续费付款失败，您的密钥将在 5 天的宽限期内继续有效，期间我们会在每个阶段通过电子邮件通知您，之后密钥将被暂停。付款结清后，已暂停的密钥会立即自动恢复。付款争议会立即暂停密钥，直至审核完成。

添加国家或升级将立即按比例收费，并在付款确认后不久应用于同一个密钥。移除国家或降级将在下次续费时生效。