按 advertiser_id 查询经纪人评价(已弃用)
查看 美国房产与房贷数据 API 的全部接口 →通过已弃用的 GET /agents/get-reviews 接口请求经纪人评价。唯一有文档说明的入参是必填的数值型 advertiser_id,该标识据文档由旧版 /agents/list 接口返回,不能用经纪人的 fulfillment_id 替代。现有 HTTP 200 示例仅为空 JSON 对象,无法据此确认评价集合、评价正文、评分、时间、作者归属或分页字段。本接口未采集到实际调用响应,空示例也不代表某位经纪人没有评价。仅建议在审计或迁移已有 advertiser_id 评价查询流程时保留此接口,并在依赖它之前核实接口可用性及响应结构。
API 功能
以 advertiser_id 定位评价请求 旧版评价请求必须使用数值型 advertiser_id,不能以经纪人姓名、邮政编码或 fulfillment_id 代替。
核对旧版目录到评价的标识传递 审查已有集成时,可依据文档核对 /agents/list 到 /agents/get-reviews 的标识传递关系;现有示例未提供含实际数据的记录来验证这一流程。
明确空对象示例的评价证据边界 提供的成功示例是 {},并非已确认的评价数组。评价正文、分数、日期及作者字段均有待验证。
限定已弃用评价接口的迁移用途 将此操作明确标记为保留的旧系统迁移接口,不承诺持续可用,也不建议将其用于新建评价产品。
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/realty-in-us/agents-get-reviews-deprecated API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-get-reviews-deprecated?key=<API_KEY>&advertiser_id=<advertiser_id>'
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-get-reviews-deprecated?key=<API_KEY>&advertiser_id=<advertiser_id>'
查询结果
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
使用场景
- 在更换评价数据来源之前,审计已有经纪人评价导入程序中保存的 advertiser_id 映射。
- 设计迁移测试,区分请求失败、空对象及包含评价数据的响应,避免将三者都判定为经纪人没有评价。
- 核实旧版评价导出数据是否包含时间和作者归属;确认存在时予以保留,不为缺失字段编造内容。
- 在集成下线计划中记录对已弃用评价接口的依赖,避免新建经纪人页面在不知情的情况下依赖未经验证的评价结构。
常见问题
旧版评价查询需要使用哪个标识?
需要在查询参数中传入数值型 advertiser_id。文档说明该值来自旧版 /agents/list 操作。经纪人的 fulfillment_id 是另一种标识,文档未说明它可以替代 advertiser_id。
成功示例为空,是否表示经纪人没有评价?
不是。提供的 HTTP 200 示例只是一个空对象,并非本接口的实际调用响应,不能据此判断某个 advertiser_id 对应的经纪人是否有评价。
哪些评价字段可以直接依赖?
现有示例未证实任何包含实际数据的评价字段。客户端依赖评价正文、评分值、时间、评价者归属或分页信息之前,都需要先行验证。
此接口能否筛选评价或进行分页?
文档未列出筛选或分页入参,唯一明确的查询参数是 advertiser_id。不要假定支持 limit、offset 或评分筛选。
新建经纪人评价应用是否应该使用此接口?
此接口已弃用,且未进行实际调用测试。应将其用于旧系统审计或迁移,而非新评价应用的推荐基础,也不能据此承诺服务会持续可用。