旧版经纪人档案查询(已弃用)

查看 美国房产与房贷数据 API 的全部接口 →

通过旧版经纪人目录和客户关系管理系统曾使用的接口约定查询经纪人档案。两个查询参数都必填:数值型 advertiser_id 和字符串型 nrds_id,分别取自目标经纪人在旧版 /agents/list 结果中的同名字段。nrds_id 应保留为文本,不能当作数值型广告主标识处理。此接口仅供审查和迁移已有接入,不建议用于新建档案页面。现有响应文档只有一个未经验证的 HTTP 200 示例,内容为空 JSON 对象({})。目前没有实测结果可供参考,因此无法确认经纪人档案属性、个人简介、联系方式、所属经纪公司字段或错误处理行为。该示例既不能证明档案不存在,也不能证明此接口目前仍然可用。与现行档案接口对照时,应明确核实经纪人身份,不能假定 advertiser_id 或 nrds_id 等同于现行接口的 fulfillment_id 或 profile_id。迁移缓存档案前,请只按相关接口约定中已经确认的字段逐项核对内容。

API 功能

广告主与 NRDS 双标识配对 明确档案查询必填的 advertiser_id 和 nrds_id,分别使用旧版经纪人列表结果中的对应字段。
NRDS 标识按文本原样保留 即使示例只含数字,也应按文档规定将 nrds_id 作为字符串处理;它与数值型 advertiser_id 是不同的标识。
迁移档案前核实经纪人身份 将身份核实列为明确的迁移步骤,不假定旧版广告主或 NRDS 标识就是现行接口的 fulfillment_id 或 profile_id。
提示档案字段尚未得到验证 明确指出未经验证的 {} 示例无法确认个人简介、联系方式、所属经纪公司字段,也不能说明档案缺失时的返回规则。

在线 API 演示

GET /api/project/realty-in-us/agents-get-profile-deprecated

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-get-profile-deprecated?key=<API_KEY>&advertiser_id=<advertiser_id>&nrds_id=<nrds_id>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

旧版经纪人档案查询需要哪些参数?

必须同时提供数值型 advertiser_id 和字符串型 nrds_id。文档说明它们分别取自旧版 /agents/list 结果中的同名字段。请选用目标经纪人对应的一组值,不要用其他类型的标识替代。

nrds_id 的示例是数字,是否应该按数值发送?

不应该。文档规定 nrds_id 的类型是字符串,而 advertiser_id 才是数值型。即使某个 nrds_id 仅包含数字,也应将它保留为文本;两个参数各有用途,不能混用。

advertiser_id 或 nrds_id 能直接作为现行接口的 profile_id 吗?

现有文档没有确认这些标识等同。建立到 profile_id 或 fulfillment_id 的映射前,请明确核实经纪人身份及现行接口的要求。

响应是否明确提供个人简介、所属经纪公司和联系方式?

现有资料没有确认这些字段。文档中的示例标为 HTTP 200,但内容仅为 {},且没有实测响应。请勿据此建立档案字段映射,也不要将其当作档案不存在的信号。

什么情况下适合参考这个已弃用的档案接口?

可依据其文档约定审查现有经纪人目录或客户关系管理系统的接入,并规划迁移。不建议用它构建新的档案页面;未经验证的示例也不能确认旧版接口目前仍然可用。

相关接口

相关指南

查看订阅方案 →