旧版经纪人推荐评价查询(已弃用)
查看 美国房产与房贷数据 API 的全部接口 →通过经纪人的广告主标识查询其旧版推荐评价资源。此接口已弃用,仅供维护现有推荐评价组件及规划迁移时参考,不建议用于新接入。唯一必填的查询参数是数值型 advertiser_id,取自目标经纪人在旧版 /agents/list 结果中的 advertiser_id 字段。文档没有列出分页或筛选参数。现有资料仅有一个标为 HTTP 200 的响应示例,内容为空 JSON 对象({});该示例未经验证,且没有实测响应可供参考。文档未明确推荐评价正文、作者署名、日期、评分、条数、结果排序或错误字段。不能把该示例当成推荐评价数量为零的证明,也不能据此保证接口目前仍然可用;此外,不应将这项资源理解为推荐经纪人搜索结果或经过验证的评分数据。若计划迁移到以 fulfillment_id 为标识的现行推荐评价接口,应明确核实经纪人身份和各项标识映射,不能直接将 advertiser_id 等同于 fulfillment_id。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/realty-in-us/agents-get-recommendations-deprecated API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-get-recommendations-deprecated?key=<API_KEY>&advertiser_id=<advertiser_id>'
查询结果
使用场景
- 定位已保存请求中含有 advertiser_id 的旧推荐评价组件,并记录各标识所对应的经纪人。
- 更改历史推荐评价记录的读取方式前,为归档的组件内容附上原始查询上下文。
- 在核实经纪人身份后,准备将旧版推荐评价的广告主标识映射到现行推荐评价接口要求的标识。
- 审查推荐评价条数与评分展示,避免未经证实的响应假设变成对外发布的口碑背书。
常见问题
查询旧版经纪人推荐评价需要哪个标识符?
需要提供数值型查询参数 advertiser_id。文档说明它取自目标经纪人在旧版 /agents/list 结果中的 advertiser_id 字段。此接口没有记录其他查询参数。
这个接口能为房产搜索查找值得推荐的经纪人吗?
文档说明的用途是按 advertiser_id 查询某位经纪人的推荐评价,而不是搜索或排名推荐经纪人。现有示例也未明确推荐评价条目的格式或排序含义。
文档中的响应是否提供推荐评价正文、作者、日期或评分?
这些字段均未得到确认。唯一的文档示例标为 HTTP 200,内容是 {},且没有实测响应。因此不能据此假定会返回推荐评价列表、评分、条数或展示顺序。
空对象示例是否表示经纪人没有推荐评价?
不是。它只是未经验证的文档示例,并非实际观测到的推荐评价数量。它既没有明确空结果规则,也不能确认接口当前是否可用,因此不应将其对外发布为“推荐评价数量为零”的结论。
旧版 advertiser_id 能原样传给使用 fulfillment_id 的现行推荐评价接口吗?
现有资料没有确认这种映射。请先核实经纪人身份与目标接口的要求,再将已经验证的标识对照关系和缓存内容来源记录保留在迁移资料中。