Knowledge API Docs

给 Teaching 调用方 / 开发同事

Knowledge 教学数据中心 API

这里不是前台产品页，而是教学标准数据服务的接口入口。Teaching 系统通过这些接口读取教材元数据、教师用书结构化内容、六元组课时内容，并提交 PDF 抽取任务。

查看接口 六元组入口

API Reference

接口清单

除健康检查外，资料查询和上传抽取接口都需要由管理员分配调用凭证。此页面只展示路径、用途和参数，不展示凭证细节。

GET 服务健康检查/health GET 资料类型与资料列表/api/v1/materials POST 创建 PDF 抽取任务/api/v1/materials/extractions GET 查看抽取任务状态/api/v1/materials/extractions/{job_id} GET 教师用书资料列表/api/sources/teacher-book GET 按教材身份读取一册书/api/sources/teacher-book/{subject}/{publisher}/{grade}/{semester} GET 按六元组查询课时内容/api/sources/teacher-book/tuples GET 六元组查询兼容入口/api/v1/public/teacher-book-tuples GET 教师用书列表兼容入口/api/v1/teacher-books GET 教师用书详情兼容入口/api/v1/teacher-books/{subject}/{publisher}/{grade}/{semester}
直接点击受保护接口时，如果浏览器没有携带调用凭证，会看到 401。这是预期行为，不代表服务不可用。

Six Tuple Query

六元组查询参数

Teaching 推荐用六元组定位课时标准内容：学科、教材版本、年级、上下册、单元、课时。查询结果返回课时 header、tuple、8 个内容字段和来源页码等追踪信息。

subject学科，例如：语文、数学、英语
publisher教材版本/出版社，例如：部编版、苏教版、译林版
grade年级，支持 1 或 一年级
semester上下册，支持 上、上册、下、下册
unit单元，可传 unit_no 或 unit_title
lesson课时，可传 lesson_no、lesson_title 或别名

Data Contract

资料模型与结构化产物

当前重点是教师用书抽取链路，同时保留学生用书、第三方练习册的统一资料中心扩展位。

教材元数据

用于确定一册资料的稳定身份。

  • subject：学科
  • publisher：教材版本
  • grade：年级
  • semester：上下册
资料类型

统一入口，分类型沉淀标准教学数据。

  • student_book：学生用书
  • teacher_book：教师用书
  • third_party_workbook：第三方练习册
教师用书产物

抽取任务完成后生成的结构化文件。

  • teacher_book.json
  • lesson_index.json
  • extraction_manifest.json
每课 8 个字段

teaching_content、teaching_objectives、key_points、difficult_points、teaching_ideas、teaching_process、examples、suggestions。

Teaching 解耦

Teaching 不维护 PDF 解析逻辑，只通过 Knowledge 读取稳定的教材和课时标准内容。

可扩展资料中心

后续学生用书、练习册可以沿用同一套元数据、抽取任务和查询模型扩展。