按学区 ID 查询美国学区信息
查看 美国房产与房贷数据 API 的全部接口 →通过 GET /schools/get-school-district 查询指定学区的详细信息。必填查询参数 id 为字符串,必须填写已核实的学区标识。此接口查询的是学区,而非单所学校,也不支持根据地址查找所属学区。文档将学校列表结果中的 districts[].id 标注为学区标识来源,但所引用的学校搜索接口目前无法作为标识发现的前置依赖。请从其他获授权的来源核实学区 ID,并保留其原始值。 本接口未提供成功验证的响应或响应示例,因此响应外层结构及学区记录字段均未经确认。现有资料不能证明响应一定包含学区名称、地址、所属学校列表、联系方式、边界几何数据、评分、入学规则或记录不存在时的错误格式。请勿承诺返回这些内容,也不要套用其他学校接口的响应结构。 学区信息面板应仅展示已在实际响应中核实的字段,并保留数据缺失和来源标记。学区资料本身不能确定房产对应的入学片区、分配学校或学生入学资格;这些事项均须向官方核实最新信息。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/realty-in-us/schools-get-school-district API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/schools-get-school-district?key=<API_KEY>&id=<id>'
查询结果
使用场景
- 在核实返回记录格式后,使用预先确认的学区 ID 填充学区信息面板。
- 为搬家选址工作台增加按需查询学区的功能,学区 ID 由获授权的外部目录提供并保存。
- 在展示所属学校、联系方式或边界等尚未确认可用的栏目之前,审核学区数据的字段映射。
- 在房产咨询流程中记录学区查询的数据来源,并将入学片区和入学资格问题引导至官方学区渠道核实。
常见问题
id 应填写学区 ID,还是单所学校的 ID?
必须填写字符串形式的学区 ID。文档引用的是学校列表结果中的 districts[].id,未说明可以用学校 ID、房产 ID、学区名称或地址代替。
学校搜索不可用时,如何准备学区查询所需的 ID?
请使用已通过获授权的外部来源核实的学区 ID。文档引用的学校搜索接口无法作为发现学区标识的前置依赖,本接口也不提供查找学区 ID 的功能。
接口会返回学区边界、评分或所属学校名单吗?
现有资料尚未确认这些字段。本接口没有可用的响应示例或成功验证结果,因此连响应外层结构和基本学区字段名称也仍待核实。
可以传入地址来查找所属学区吗?
文档未列出地址参数,唯一明确的输入是必填字符串参数 id,即学区 ID。地址与学区的对应关系需要通过其他来源核实。
学区记录能否用于判断入学资格?
不能。仅凭学区详情无法确定房产所属的入学片区、具体分配学校或学生是否符合入学条件。相关决定应以官方学区的最新信息为准。