旧版经纪人档案查询(已弃用)
查看 美国房产与房贷数据 API 的全部接口 →通过旧版经纪人目录和客户关系管理系统曾使用的接口约定查询经纪人档案。两个查询参数都必填:数值型 advertiser_id 和字符串型 nrds_id,分别取自目标经纪人在旧版 /agents/list 结果中的同名字段。nrds_id 应保留为文本,不能当作数值型广告主标识处理。此接口仅供审查和迁移已有接入,不建议用于新建档案页面。现有响应文档只有一个未经验证的 HTTP 200 示例,内容为空 JSON 对象({})。目前没有实测结果可供参考,因此无法确认经纪人档案属性、个人简介、联系方式、所属经纪公司字段或错误处理行为。该示例既不能证明档案不存在,也不能证明此接口目前仍然可用。与现行档案接口对照时,应明确核实经纪人身份,不能假定 advertiser_id 或 nrds_id 等同于现行接口的 fulfillment_id 或 profile_id。迁移缓存档案前,请只按相关接口约定中已经确认的字段逐项核对内容。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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 配对。
- 为迁移已保存的经纪人目录档案,建立经人工确认的经纪人身份与现行档案标识对照表。
- 审查将纯数字 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,但内容仅为 {},且没有实测响应。请勿据此建立档案字段映射,也不要将其当作档案不存在的信号。
什么情况下适合参考这个已弃用的档案接口?
可依据其文档约定审查现有经纪人目录或客户关系管理系统的接入,并规划迁移。不建议用它构建新的档案页面;未经验证的示例也不能确认旧版接口目前仍然可用。