使用成对房源与房产标识获取旧版房产详情(已弃用)
查看 美国房产与房贷数据 API 的全部接口 →此旧版房产详情接口仅保留用于兼容与迁移,不建议新项目使用。查询时必须同时提供三个字符串参数:listing_id、property_id 和 prop_status。文档说明 listing_id 与 property_id 应取自房源搜索结果,包括旧版及第二版房源列表接口的结果。务必使用同一条搜索记录中的房源标识与房产标识;两者含义不同,不可相互替代。prop_status 的文档可选值为 for_sale 和 for_rent。listing_id=608763437、property_id=4599450556 等仅为示例,并非已核验的当前有效记录。 目前没有本接口的请求核验记录,因此接口可用性、标识有效性及当前响应约定均未确认。不完整的文档示例使用顶层 listing 对象,其 address 部分展示 city、county、state、state_code、postal_code、line、lat、long、neighborhood_name、neighborhoods 和 time_zone。其他可见 listing 字段包括 beds、baths、baths_full、advertiser_type、agent、branding、broker、client_display_flags、client_display_text、client_event_data 和 client_provider_data。上述均只是文档示例字段,不能保证当前仍会返回、内容完整,或与新版详情响应等价。 迁移前应先盘点已存储的标识组合与状态值,再单独确认当前详情接口的输入要求和输出结构,之后再调整链接或字段映射。接口已弃用并不意味着已有明确下线日期,也不保证服务会持续可用。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/realty-in-us/properties-detail-deprecated API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-detail-deprecated?key=<API_KEY>&listing_id=<listing_id>&prop_status=for_sale&property_id=<property_id>'
查询结果
使用场景
- 核查已保存的房产详情链接,区分 listing_id 与 property_id,并标记缺少任一标识或关联 prop_status 的记录。
- 维护已有的出售或出租房产详情集成,同时明确标注接口已弃用且当前可用性尚未核验。
- 为旧版 listing.address、beds、baths 和 baths_full 建立迁移映射清单,不假定新版响应沿用相同字段路径。
- 整理历史房源搜索导出数据,先确认房源标识与房产标识来自同一记录,再构造旧版详情请求。
- 在调整现有房产链接前,编写兼容性测试,对比各自独立核验过的旧版与当前详情接口约定。
常见问题
新应用应该使用这个房产详情接口吗?
不应该。此接口已明确弃用,仅保留用于旧系统兼容与迁移。新项目应在确认当前详情接口自身的入参要求与响应结构后,使用当前接口。
listing_id 和 property_id 都必须提供吗?
是的。这两个字符串参数与 prop_status 均为必填。两个标识应来自同一条房源搜索结果,文档指向旧版及第二版列表结果。不要用一个标识值代替另一个。
prop_status 支持哪些文档值?
文档列出的值为 for_sale 和 for_rent。应使用房源记录对应的状态,不要根据标识自行推断。目前没有使用当前记录核验任一状态的请求记录。
示例标识一定能查到房产吗?
不能保证。示例房源标识和房产标识只是文档示例,并非已核验的当前有效记录。应从适当的房源列表结果取得匹配的一对标识,不要将占位示例当成已知可用的房产。
这个已弃用接口有哪些已经确认的响应字段?
尚无字段经过请求核验。不完整的文档示例展示了 listing.address、beds、baths、baths_full、advertiser_type、agent、branding、broker 及客户端相关部分,但它们当前是否存在、是否完整仍未确认。
迁移时只替换详情 URL 就可以了吗?
不能这样假定。应先盘点已存储的 listing_id、property_id 和 prop_status,再确认当前详情接口要求的标识与字段路径。接口已弃用并不证明新旧响应布局相同,也没有据此确定下线日期。