现在还没有相册
现在还没有记录
- 性别保密
- 生日
- QQ
- 个人主页https://opendata-api.com/zh/realtor/property-detail-deprecated.html
- 自我介绍bio
- 兴趣爱好============================
Realtor 旧版详情 API：已弃用双 ID 接口与 v2 迁移指南
============================
Realtor 美国房产数据接口（旧版详情）怎么用、何时该迁移，一篇讲清
--------------------
INTRODUCTION
--------------------
美国房产数据是房源聚合站、投资分析工具和找房 App 的基础燃料。随着数据源接口不断迭代，很多团队手里都留有早期按 propertyId 与 listingId 取详情的老客户端，如何平稳维护、有序迁移，成为房产 open data 接入中的现实问题。
--------------------
FEATURED API
--------------------
本文介绍 Global API Gateway 上的 Realtor 美国房产数据接口之一：「查询旧版房源详情（已弃用）」，接口路径为 GET /api/project/realtor/property-detail-deprecated。
页面对它的定位很明确：
• 文档已标记弃用，且本接口未实测，响应字段和持续可用性未确认
• 仅为已有集成保留参考，不推荐新项目以此开始
• 新开发应优先使用 property-v2-detail，并把当前搜索取得的 property_id 作为 query
------------
核心参数
------------
• propertyId（必填）：当前搜索记录中的 property_id
• listingId（必填）：同一搜索记录中的 listing_id
--------------------
WHAT CAN BE INTEGRATED
--------------------
• 明确弃用的兼容入口：为已有客户端保留参考
• 旧版双标识：propertyId 与 listingId 必须描述同一条搜索挂牌
• 迁移到 v2：property-v2-detail 以 property_id 作为 query
• 逐字段评估：旧响应未观察，先对照实际字段再替换生产解析逻辑
• 身份区分：保持房产身份与挂牌身份的区别
• 在线测试：页面内置交互式演示，可直接填参数查看 JSON 响应
--------------------
USE CASES
--------------------
[1] 旧客户端维护
✓ 评估当前可用性的同时，暂时维护已有双 ID 详情客户端
[2] 迁移测试规划
✓ 规划从旧版标识对到已实测 v2 query 的迁移测试
[3] 下线前字段核对
✓ 停用旧详情客户端之前，对照业务必需字段是否仍可获得
[4] 数据清理
✓ 在旧数据清理中识别房产 ID 与挂牌 ID 配对错误的记录
[5] 房产数据 API 选型
✓ 新项目直接对照 v2 详情，避免在弃用接口上起步
--------------------
PRICING & GETTING STARTED
--------------------
• 统一一个 API Key 调用，按点数计费，不同接口点数消耗不同
• 注册即送 100 点数，无需绑定信用卡，点数永不过期
• 经 Stripe 支付，支持退款
• 登录后可在文档页的在线测试工具中直接在浏览器试跑接口
--------------------
CONCLUSION
--------------------
旧版 Realtor 详情 API 适合"维护现状、规划迁移"，而不是新项目的起点。建议先用免费点数核对旧接口的可用性与字段差异，再切换到 v2 查询。
免费试用 / 查看文档：
https://opendata-api.com/zh/realtor/property-detail-deprecated.html
------ị
last updateTime: 2026-10-14 16:36:46a
现在还没有动态
现在还没有日志
现在还没有好友
最近访客
现在还没有访客