旧版经纪人房源列表查询(已弃用)
查看 美国房产与房贷数据 API 的全部接口 →按旧版接口约定查询与经纪人关联的房源。此接口已弃用,仅适合维护和审查现有经纪人页面,不建议用于新接入。三个必填查询参数必须取自同一条旧版 /agents/list 结果:agent_id 为 member/id 中的数值,fulfillment_id 为 advertiser_id 中的数值,id 为 abbreviation 中的字符串。可选参数 page 用于选择页码;type 可选 all、forSale、forSold、forRent 或 openHouses。文档示例使用 page=1 和 type=all,但未明确省略参数时的行为,也未说明每页条数。现有响应文档仅提供一个未经验证的 HTTP 200 示例,内容为空 JSON 对象({})。目前没有实测响应可供参考,文档也未明确房源字段、结果总数、分页结构或错误格式。不能据此认定经纪人没有房源,也不能认定该弃用接口目前仍然可用。迁移已保存的页面前,应对照现行经纪人房源接口核实标识符要求和响应结构,不要假定不同接口的标识符可以直接互换。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/realty-in-us/agents-get-listings-deprecated API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-get-listings-deprecated?key=<API_KEY>&agent_id=<agent_id>&fulfillment_id=<fulfillment_id>&id=<id>'
查询结果
使用场景
- 盘点依赖原有 agent_id、fulfillment_id 和 abbreviation 组合的已保存经纪人房源页面。
- 重新设计在售、已售、出租及开放看房标签页的导航前,记录旧页面实际使用的 page 和 type 取值。
- 建立经人工核实的迁移测试集,对照弃用房源查询接口与现行经纪人房源接口的约定。
- 审查缓存的旧版房源展示,避免将缺少字段说明的空对象示例误当成可用房源数量为零的证据。
常见问题
旧版经纪人房源查询需要哪些标识符?
三个参数都必填:数值型 agent_id、数值型 fulfillment_id 和字符串型 id。旧版 /agents/list 文档将它们分别对应到 member/id、advertiser_id 和 abbreviation。请使用同一条经纪人结果中的配套值,不要通过其中一个值推导另一个值。
type 参数支持哪些已记录的房源类型?
文档列出的取值为 all、forSale、forSold、forRent 和 openHouses。此参数可选,示例使用 all,但现有资料并未确认省略时的行为,也未确认每个类别目前是否仍然可用。
这个弃用接口如何指定分页?
可通过可选的数值型 page 参数选择页码,文档示例为 1。文档没有明确每页条数、页码上限、总数字段或响应中的分页结构。
响应中有哪些可以依赖的房源字段?
现有资料尚未确认任何房源字段。唯一的文档示例标为 HTTP 200,内容仅为 {},没有房源字段。该示例未经验证,也没有实测响应,因此不能将它当成已经证实的空房源结果。
新的经纪人房源页面应该使用此接口吗?
不应该。此接口已弃用,仅供已有接入在迁移时参考。迁移已保存的页面前,请核对现行经纪人房源接口的约定,并验证标识符映射和响应字段;该旧版接口不提供自动转换或回退功能。