查询旧版房源详情(已弃用)
查看全部 Realtor 美国房产数据 API →旧版详情接口要求同一搜索记录中的 propertyId 与 listingId,文档已标记弃用,且本接口未实测,响应字段和持续可用性未确认。保留它用于已有集成参考,不推荐新项目以此开始。新开发应优先使用 property-v2-detail,将当前搜索取得的 property_id 作为 query。迁移前比较真实字段可用性,并保持房产身份与挂牌身份的区别。
API 功能
明确弃用的兼容入口 仅为已有客户端保留参考,不是新详情集成的推荐方案。
旧版必填双标识 propertyId 和 listingId 都必填,必须描述同一条搜索挂牌。
迁移到已实测 v2 查询 property-v2-detail 可将当前搜索 property_id 作为 query。
逐字段评估旧版替换 旧响应未观察,应先对照实际字段,再替换生产环境解析逻辑。
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/realtor/property-detail-deprecated API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-detail-deprecated?key=<API_KEY>&propertyId=<propertyId>&listingId=<listingId>'
curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-detail-deprecated?key=<API_KEY>&propertyId=<propertyId>&listingId=<listingId>'
查询结果
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
使用场景
- 评估当前可用性的同时,暂时维护已有双 ID 详情客户端。
- 规划从旧版标识对到已实测 v2 query 的迁移测试。
- 停用旧详情客户端之前,对照业务必需字段是否仍可获得。
- 在旧数据清理中识别房产 ID 与挂牌 ID 配对错误的记录。
常见问题
新项目还应该从旧版 /detail 开始吗?
不建议。该接口已弃用且未实测,新开发优先参考 property-v2-detail,并从当前搜索取得 property_id。
旧版需要的 propertyId 与 listingId 能来自不同记录吗?
不能。必须从同一搜索挂牌取出房产和挂牌标识,混用可能错误关联;旧 ID 组合的实际行为也未验证。
迁移到 v2 是否可以直接不做字段检查?
不可以。旧版响应未观察,应比较实际可用字段、空值与业务依赖,再替换解析器,同时把双 ID 输入改为 v2 query。